소개
개요
HTTP 응답
코드 |
설명 |
200 |
Function successfully executed. |
400 |
Invalid API location. Check the URL that you are using. |
403 |
Invalid or missing API key. Check that your API key is present and matches your assigned
key.
|
405 |
Invalid HTTP method. Check that the method (POST / GET) |
412 |
Request failed. Check the response body for a more detailed description. |
500 |
Internal server error. Try again at a later time. |
503 |
Rate limit hit. API requests are limited to an average of 1/s. Try your request again
later.
|
API 사용
인증
인증이 필요한 API 요청의 경우 'token : 발급토큰'을 Parameter로 보내야합니다. 이를 수행하는 방법에 대한 자세한 정보는 아래의 각 항목의 cURL 예제를
참조하십시오.
토큰 발급
POST /v1/auth
토큰의 유효기간은 생성일을 포함한 365일 입니다.
Header
Parameter
Response
-
Name
|
Type
|
Description
|
token
|
String
|
인증이 필요한 요청에서 사용하는 토큰
|
-
Name
|
Type
|
Description
|
code
|
Integer
|
HTTP 응답코드
|
success
|
Boolean
|
요청 성공 여부
|
message
|
String
|
요청 응답메시지
|
cURL 요청 예제
curl -X POST -H "Accept: application/json" -d 'apikey={발급키}' https://api.koreassl.com/v1/auth
응답 예제
{
"data": {
"token": "f837762e000095df34873b6165dwf2cf"
},
"status": {
"code": 200,
"success": true,
"message": "success"
}
}
발급 서버 상태
POST /v1/ca/status
인증기관 발급 서버의 상태를 조회합니다.
Header
Parameter
Response
-
Name
|
Type
|
Description
|
list
|
list[]
|
인증기관 목록
|
-
Name
|
Type
|
Description
|
ca
|
String
|
CA (인증기관)
|
status
|
String
|
CA 발급 서버 상태 (good:정상 / bad:발급지연)
|
-
Name
|
Type
|
Description
|
code
|
Integer
|
HTTP 응답코드
|
success
|
Boolean
|
요청 성공 여부
|
message
|
String
|
요청 응답메시지
|
cURL 요청 예제
curl -X GET -H "Accept: application/json" https://api.koreassl.com/v1/ca/status?token={토큰}
응답 예제
{
"data": [
{
"ca": "sectigo",
"status": "good"
},
{
"ca": "gogetssl",
"status": "good"
},
{
"ca": "digicert",
"status": "good"
},
{
"ca": "thawte",
"status": "good"
},
{
"ca": "geotrust",
"status": "good"
},
{
"ca": "rapidssl",
"status": "good"
},
{
"ca": "symantec",
"status": "good"
},
{
"ca": "globalsign",
"status": "good"
},
{
"ca": "entrust",
"status": "good"
},
{
"ca": "certum",
"status": "bad"
},
{
"ca": "koreassl",
"status": "good"
}
],
"status": {
"code": 200,
"success": true,
"message": "success"
}
}
제품 목록
GET /v1/product/list
주문가능한 인증서 목록
Header
Parameter
Response
-
Name
|
Type
|
Description
|
products
|
products[]
|
제품
|
-
Name
|
Type
|
Description
|
product_code
|
String
|
제품코드 (제품 주문시 필요한 항목)
|
product
|
String
|
제품명
|
product_cate
|
String
|
제품종류 (single / multi / wildcard / multi-wildcard / s/mime / document)
|
validation_method
|
String
|
검증 (DV / OV / EV)
|
ca
|
String
|
인증기관
|
price1_yn
|
String
|
1년 주문가능여부 (Y:가능 / N:불가능)
|
price2_yn
|
String
|
2년 주문가능여부 (Y:가능 / N:불가능)
|
price3_yn
|
String
|
3년 주문가능여부 (Y:가능 / N:불가능)
|
price4_yn
|
String
|
4년 주문가능여부 (Y:가능 / N:불가능)
|
price5_yn
|
String
|
5년 주문가능여부 (Y:가능 / N:불가능)
|
price6_yn
|
String
|
6년 주문가능여부 (Y:가능 / N:불가능)
|
price_1
|
Integer
|
1년 판매가 (원)
|
price_2
|
Integer
|
2년 판매가 (원)
|
price_3
|
Integer
|
3년 판매가 (원)
|
price_4
|
Integer
|
4년 판매가 (원)
|
price_5
|
Integer
|
5년 판매가 (원)
|
price_6
|
Integer
|
6년 판매가 (원)
|
san_price
|
Integer
|
1개당 SAN 판매가 (원)
|
def_san
|
Integer
|
기본제공 SAN 개수
|
san_limit
|
Integer
|
최대수량 SAN 개수
|
warranty
|
Double
|
배상액 (달러)
|
unlimited_servers
|
Integer
|
무제한 서버 (0:무제한 / 1,2..~:제한)
|
ip_common_yn
|
String
|
메인 도메인 Public IP 주문가능여부 (Y:주문가능 | N:주문불가능)
|
ip_san_yn
|
String
|
서브(SAN) 도메인 Public IP 주문가능여부 (Y:주문가능 | N:주문불가능)
|
-
Name
|
Type
|
Description
|
code
|
Integer
|
HTTP 응답코드
|
success
|
Boolean
|
요청 성공 여부
|
message
|
String
|
요청 응답메시지
|
cURL 요청 예제
curl -X GET -H "Accept: application/json" https://api.koreassl.com/v1/product/list?token={토큰}
응답 예제
{
"data": {
"products": [
{
"product_code": "k32l112023d378abcd1572efbc371234",
"product": "PositiveSSL",
"product_cate": "single",
"validation_method": "DV",
"ca": "Sectigo",
"price1_yn": "Y",
"price2_yn": "Y",
"price3_yn": "Y",
"price4_yn": "Y",
"price5_yn": "N",
"price6_yn": "N",
"price_1": 7650,
"price_2": 13600,
"price_3": 20400,
"price_4": 26350,
"price_5": 0,
"price_6": 0,
"san_price": 0,
"def_san": 0,
"san_limit": 0,
"warranty": 10000.0,
"unlimited_servers": 0,
"ip_common_yn": "Y",
"ip_san_yn": "N"
},
{
"product_code": "k3abc120xyz378abcd1572efbcdef234",
"product": "PositiveSSL Wildcard",
"product_cate": "wildcard",
"validation_method": "DV",
"ca": "Sectigo",
"price1_yn": "Y",
"price2_yn": "Y",
"price3_yn": "Y",
"price4_yn": "Y",
"price5_yn": "N",
"price6_yn": "N",
"price_1": 106600,
"price_2": 196800,
"price_3": 246000,
"price_4": 310780,
"price_5": 0,
"price_6": 0,
"san_price": 0,
"def_san": 0,
"san_limit": 0,
"warranty": 10000.0,
"unlimited_servers": 0,
"ip_common_yn": "N",
"ip_san_yn": "N"
},
{
"product_code": "k3abc120xyz378abcd1572efbcdef789",
"product": "QuickSSL Premium",
"product_cate": "single",
"validation_method": "DV",
"ca": "GeoTrust",
"price1_yn": "Y",
"price2_yn": "Y",
"price3_yn": "N",
"price4_yn": "N",
"price5_yn": "N",
"price6_yn": "N",
"price_1": 89100,
"price_2": 152100,
"price_3": 0,
"price_4": 0,
"price_5": 0,
"price_6": 0,
"san_price": 0,
"def_san": 0,
"san_limit": 0,
"warranty": 500000.0,
"unlimited_servers": 0,
"ip_common_yn": "Y",
"ip_san_yn": "N"
},
...
],
},
"status": {
"code": 200,
"success": true,
"message": "success"
}
}
인증서 주문
POST /v1/order/add
인증서 신규/갱신 발급 요청
Header
Parameter
- 토큰 / 필수
- 주문타입 / 필수 / (입력하실값: new|renew 중 택1)
- 결제방법 / 필수 / (입력하실값: balance|postpaid 중 택1)
- 제품코드 / 필수
- 인증기간(개월) / 필수 / (입력하실값: 12|24|36|48|60|72 중 택1)
- 예약 발급으로 신청 / 선택 / (입력하실값: Y)
- 예약 발급일 / 선택 또는 필수 / (예약 발급 신청시 필수, 입력하실값: 예: 2020-09-23)
-
도메인 / 필수 / (한글도메인: 퓨니코드)
도메인 / 필수 / (한글도메인: 퓨니코드)
SAN 도메인명(콤마로 구분) / 선택 또는 필수 / (domain을 제외한 추가 도메인만 입력: domain2.com,domain3.com,...)
추가 SAN 도메인(숫자) / 선택
도메인 / 필수 / (*.domain.com, 한글도메인: 퓨니코드)
도메인 / 필수 / (*.domain.com, 한글도메인: 퓨니코드)
SAN 도메인명(콤마로 구분) / 선택 또는 필수 / (domain을 제외한 추가 도메인만 입력: *.domain2.com,*.domain3.com,...)
추가 SAN 도메인(숫자) / 선택
IP 주소 / 필수
SAN IP(콤마로 구분) / 선택 / (domain을 제외한 추가 도메인만 입력: 142.250.66.142,17.253.144.10,...)
추가 SAN 도메인(숫자) / 선택
-
domain 소유인증 / 필수 / (입력하실값: email)
domain 소유인증 이메일주소 / 필수
SAN 도메인별 DCV(콤마로 구분) / 선택 또는 필수 / (domain을 제외한 추가 Email 입력: support@koreassl.com,manager@koreassl.com...)
domain 소유인증 / 필수 / (입력하실값: dns|http|https 중 택1)
SAN 도메인별 DCV(콤마로 구분) / 선택 또는 필수 / (domain을 제외한 추가 DCV만 입력: dns,http,...)
-
직접생성 / 필수
계정의 이메일주소로 CSR 메일 전송 / 필수 / (입력하실값: Y|N, auto_csr:Y일 경우에만 발송가능)
자동생성여부 / 필수 / (Y)
Common name(도메인)명 / 필수
영문 회사명 / 필수
영문 부서명 / 필수
영문 국가코드(2자) / 필수 / (예 KR)
영문 도 / 필수
영문 시 / 필수
이메일주소 / 필수
선택 / (기본 2048bit)
계정의 이메일주소로 CSR 메일 전송 / 필수 (입력하실값: Y|N)
-
관리자 영문 회사명 / 필수 / (예 DEEPACT Inc.)
관리자 영문 성 / 필수
관리자 영문 이름 / 필수
관리자 이메일주소 / 필수
관리자 연락처(숫자만) / 필수 / (예 82216444308)
관리자 영문 직급 / 필수 / (예 CEO)
관리자 영문 시 / 필수 / (예 Seoul)
관리자 영문 도 / 필수 / (예 None)
관리자 영문 상세주소 / 필수 / (예 161, Yanghwa-ro, Mapo-gu)
관리자 우편번호(숫자만) / 필수
관리자 영문 국가코드(2자) / 필수 / (예 KR)
관리자정보와 기술자정보가 동일 /(기본값:N / 입력하실값: Y|N)
기술자 영문 회사명 / 선택적 필수(admin_to_tech=N) / (예 DEEPACT Inc.)
기술자 영문 성 / 선택적 필수(admin_to_tech=N)
기술자 영문 이름 / 선택적 필수(admin_to_tech=N)
기술자 이메일주소 / 선택적 필수(admin_to_tech=N)
기술자 연락처(숫자만) / 선택적 필수(admin_to_tech=N) / (예 82216444308)
기술자 영문 직급 / 선택적 필수(admin_to_tech=N) / (예 Manager)
기술자 영문 시 / 선택적 필수(admin_to_tech=N) / (예 Seoul)
기술자 영문 도 / 선택적 필수(admin_to_tech=N) / (예 None)
기술자 영문 상세주소 / 선택적 필수(admin_to_tech=N) / (예 161, Yanghwa-ro, Mapo-gu)
기술자 우편번호(숫자만) / 선택적 필수(admin_to_tech=N) / (예 03995)
기술자 영문 국가코드(2자) / 선택적 필수(admin_to_tech=N) / (예 KR)
관리자 영문 회사명 / 필수 / (예 DEEPACT Inc.)
관리자 영문 성 / 필수
관리자 영문 이름 / 필수
관리자 이메일주소 / 필수
관리자 연락처(숫자만) / 필수 / (예 82216444308)
관리자 영문 직급 / 필수 / (예 CEO)
관리자 영문 시 / 필수 / (예 Seoul)
관리자 영문 도 / 필수 / (예 None)
관리자 영문 상세주소 / 필수 / (예 161, Yanghwa-ro, Mapo-gu)
관리자 우편번호(숫자만) / 필수 / (예 03995)
관리자 영문 국가코드(2자) / 필수 / (예 KR)
기술자 영문 회사명 / 필수 / (예 DEEPACT Inc.)
기술자 영문 성 / 필수
기술자 영문 이름 / 필수
기술자 이메일주소 / 필수
기술자 연락처(숫자만) / 필수 / (예 82216444308)
기술자 영문 직급 / 필수 / (예 Manager)
기술자 영문 시 / 필수 / (예 Seoul)
기술자 영문 도 / 필수 / (예 None)
기술자 영문 상세주소 / 필수 / (예 161, Yanghwa-ro, Mapo-gu)
기술자 우편번호(숫자만) / 필수 / (예 03995)
기술자 영문 국가코드(2자) / 필수 / (예 KR)
회사 영문 회사명 / 필수 / (예 DEEPACT Inc.)
회사 영문 부서명 / 필수 / (예 IT Develop)
회사 연락처(숫자만) / 필수 / (예 82216444308)
회사 영문 시 / 필수 / (예 Seoul)
회사 영문 도 / 필수 / (예 None)
회사 영문 상세주소 / 필수 / (예 161, Yanghwa-ro, Mapo-gu)
회사 우편번호(숫자만) / 필수 / (예 03995)
회사 영문 국가코드(2자) / 필수 / (예 KR)
회사 DUNS Number / 선택 help
회사 LEI Code / 선택 help
-
* token 항목은
토큰 발급을 참조해주세요.
* product_code 항목은
제품을 참조해주세요.
Response
-
Name
|
Type
|
Description
|
order_code
|
String
|
주문코드
|
balance
|
Integer
|
예치금 잔액 (원) / 예치금으로 결제시
|
pay
|
Integer
|
지불한 금액 (원)
|
csr
|
String
|
CSR code / S/MIME 제품 제외
|
key
|
String
|
KEY code / S/MIME 제품 제외 / CSR 직접생성시 NULL
|
-
Name
|
Type
|
Description
|
code
|
Integer
|
HTTP 응답코드
|
success
|
Boolean
|
요청 성공 여부
|
message
|
String
|
요청 응답메시지
|
cURL 요청 예제
curl -X POST -H "Accept: application/json" -d 'token={토큰}&Parameter1={값1}&Parameter2={값2}...' https://api.koreassl.com/v1/order/add
응답 예제
{
"data":{
"order_code": "bc8c35800a4414647bb19a0e623a6b69",
"balance": 9905480,
"pay": 8410,
"csr": "-----BEGIN CERTIFICATE REQUEST-----\n1IIC2....\n-----END CERTIFICATE REQUEST-----\n",
"key": "-----BEGIN PRIVATE KEY-----\MIIGA....\n-----END PRIVATE KEY-----\n"
},
"status":{
"code": 200,
"success": true,
"message": "success"
}
}
응답 예제
(S/MIME)
{
"data": {
"order_code": "f9d0a96588d42db96316867c58d23466",
"balance": 8063030,
"pay": 33000
},
"status": {
"code": 200,
"success": true,
"message": "success"
}
}
인증서 다운로드
POST /v1/cert/download
발급 완료된 인증서를 다운로드
Header
Parameter
Response
-
Name
|
Type
|
Description
|
link
|
String
|
다운로드 링크 (링크 접속시 만료)
|
-
Name
|
Type
|
Description
|
code
|
Integer
|
HTTP 응답코드
|
success
|
Boolean
|
요청 성공 여부
|
message
|
String
|
요청 응답메시지
|
cURL 요청 예제
curl -X POST -H "Accept: application/json" -d 'token={토큰}&order_code={주문코드}&type={파일종류}' https://api.koreassl.com/v1/cert/download
응답 예제
{
"data": {
"link": "https://api.koreassl.com/link/cert/download/A/70ccfccccabbb77e0acf06f5298c0aaa"
},
"status": {
"code": 200,
"success": true,
"message": "success"
}
}
DCV 인증방법 변경
POST /v1/validation/changeValidationMethod
인증서의 DCV(도메인 소유 인증) 인증방법(email / dns / http / https)을 변경
Header
Parameter
- 토큰 / 필수
- 주문코드 / 필수
- 도메인별 DCV(콤마로 구분) / 필수 / (DCV 입력: dns,http,admin@admin.com...)
- 도메인명(콤마로 구분) / 필수 / (도메인 입력: domain2.com,domain3.com,domain4.tld...)
-
* token 항목은
토큰 발급을 참조해주세요.
* dcv: email의 경우에는
Whois에 등록된 이메일을 기재해주셔야 정상적으로 이메일이 전송됩니다.
Response
-
Name
|
Type
|
Description
|
code
|
Integer
|
HTTP 응답코드
|
success
|
Boolean
|
요청 성공 여부
|
message
|
String
|
요청 응답메시지
|
cURL 요청 예제
curl -X POST -H "Accept: application/json" -d 'token={토큰}&order_code={주문코드}&new_methods=dns,http,admin@adsmin.com&domains=domain1.com,domain2.com,domain3.tld' https://api.koreassl.com/v1/validation/changeValidationMethod
응답 예제
{
"fail_domains": "",
"success_domains": "domain1.com,domain2.com,domain3.tld",
"status": {
"code": 200,
"success": true,
"message": "success"
}
}
주문 내역
GET /v1/order/list
인증서 주문 내역
Header
Parameter
- 토큰 / 필수
- 도메인명 / 선택 (멀티인증서의 경우 추가 도메인 포함 검색)
- 상태 / 선택 (입력하실값:
active
/
ready
/
processing
/
pending
/
cancelled
/
failed
/
expired
/
hold
/
rejected
/
incomplete)
- 예약 발급 / 선택 (입력하실값: Y|N)
Response
-
Name
|
Type
|
Description
|
certs
|
certs[]
|
인증서 목록
|
-
Name
|
Type
|
Description
|
count
|
int
|
인증서 개수
|
-
Name
|
Type
|
Description
|
remarks
|
order_type
|
String
|
주문종류
|
NULL: 주문전 / new: 신규 / renew: 갱신
|
order_id
|
String
|
주문ID (고객지원용)
|
|
order_code
|
String
|
주문코드
|
|
ca
|
String
|
인증기관
|
|
product
|
String
|
제품명
|
|
product_cate
|
String
|
제품종류
|
single / multi / wildcard / multi-wildcard
|
validation_method
|
String
|
검증
|
DV / OV / EV
|
period
|
Integer
|
기간 (개월)
|
3 / 12 / 24 / 36 / 48 / 60 / 72
|
san
|
Integer
|
SAN 추가 개수 (추가도메인)
|
0: 추가없음
|
csr_code
|
String
|
CSR 코드
|
NULL: 주문전
|
crt_code
|
String
|
CRT 코드
|
NULL: 발급전
|
ca_code
|
String
|
CA 코드
|
NULL: 발급전
|
key_code
|
String
|
Key 코드
|
NULL: 주문전 / CSR 직접생성
|
domain
|
String
|
도메인
|
NULL: 주문전
|
domains
|
String
|
추가 도메인
|
NULL: 주문전 또는 추가없음
|
dcv
|
String
|
DCV
|
NULL: 주문전 / email / dns / http / https
|
dcv_email
|
String
|
DCV Email
|
NULL: DCV 인증이 email이 아닐 경우
|
dcv_http_link
|
String
|
DCV http/https link
|
NULL: DCV 인증전 (주문진행중)
|
dcv_http_filename
|
String
|
DCV http/https filename
|
NULL: DCV 인증전 (주문진행중)
|
dcv_http_content
|
String
|
DCV http/https content
|
NULL: DCV 인증전 (주문진행중)
|
dcv_dns_record
|
String
|
DCV DNS record
|
NULL: DCV 인증전 (주문진행중)
|
dcv_status
|
String
|
Common name (도메인) DCV 인증상태
|
1: 인증전 / 2: 인증됨
|
san_dcv_req
|
String
|
멀티도메인 | 멀티와일드에 해당
SAN 도메인별 DCV (Common name을 제외한 DCV: abc@abc.com, dns, ...)
|
NULL: SAN 도메인별 DCV 인증전 (주문진행중)
|
san_dcv_res
|
san_dcv_res[]
|
멀티도메인 | 멀티와일드에 해당
SAN DCV 요청결과
|
NULL: SAN 도메인별 DCV 인증전 (주문진행중)
|
valid_from
|
String
|
인증서 유효기간 시작일
|
NULL: 발급전
|
valid_till
|
String
|
인증서 유효기간 종료일
|
NULL: 발급전
|
valid_till_total
|
String
|
인증서 유효기간 최종 종료일(다년)
|
NULL: 발급전
|
admin_firstname
|
String
|
관리자 이름
|
NULL: 주문전
|
admin_lastname
|
String
|
관리자 성
|
NULL: 주문전
|
admin_email
|
String
|
관리자 이메일
|
NULL: 주문전
|
admin_phone
|
String
|
관리자 연락처
|
NULL: 주문전
|
admin_title
|
String
|
관리자 직급
|
NULL: 주문전
|
admin_city
|
String
|
관리자 주소 (시)
|
NULL: 주문전
|
admin_address
|
String
|
관리자 상세주소
|
NULL: 주문전
|
admin_state
|
String
|
관리자 주소 (도)
|
NULL: 주문전
|
admin_zipcode
|
String
|
관리자 우편번호
|
NULL: 주문전
|
admin_country
|
String
|
관리자 국가코드
|
NULL: 주문전
|
admin_organization
|
String
|
관리자 회사
|
NULL: 주문전
|
tech_firstname
|
String
|
기술자 이름
|
NULL: 주문전
|
tech_lastname
|
String
|
기술자 성
|
NULL: 주문전
|
tech_email
|
String
|
기술자 이메일
|
NULL: 주문전
|
tech_phone
|
String
|
기술자 연락처
|
NULL: 주문전
|
tech_title
|
String
|
기술자 직급
|
NULL: 주문전
|
tech_city
|
String
|
기술자 주소 (시)
|
NULL: 주문전
|
tech_address
|
String
|
기술자 상세주소
|
NULL: 주문전
|
tech_state
|
String
|
기술자 주소 (도)
|
NULL: 주문전
|
tech_zipcode
|
String
|
기술자 우편번호
|
NULL: 주문전
|
tech_country
|
String
|
기술자 국가코드
|
NULL: 주문전
|
tech_organization
|
String
|
기술자 회사
|
NULL: 주문전
|
company_organization
|
String
|
회사명
|
NULL: 주문전
|
company_department
|
String
|
회사 부서
|
NULL: 주문전
|
company_duns
|
String
|
회사 DUNS Number
|
NULL: 주문전
|
company_lei
|
String
|
회사 LEI코드
|
NULL: 주문전
|
company_phone
|
String
|
회사 전화번호
|
NULL: 주문전
|
company_city
|
String
|
회사 주소 (시)
|
NULL: 주문전
|
company_state
|
String
|
회사 주소 (도)
|
NULL: 주문전
|
company_zipcode
|
String
|
회사 우편번호
|
NULL: 주문전
|
company_address
|
String
|
회사 상세주소
|
NULL: 주문전
|
company_country
|
String
|
회사 국가코드
|
NULL: 주문전
|
booking_yn
|
String
|
예약 여부
|
Y: 예약 / N: 즉시발급
|
booking_dt
|
String
|
발급 예약일
|
NULL: 즉시발급
|
status
|
String
|
상태
|
active
/
ready
/
processing
/
pending
/
cancelled
/
failed
/
expired
/
hold
/
rejected
/
incomplete
|
-
Name
|
Type
|
Description
|
status_description
|
String
|
SAN DCV 상태
|
san_name
|
String
|
SAN 도메인 명
|
validation_method
|
String
|
검증
|
validation
|
http
|
검증결과
|
status
|
String
|
검증상태
|
-
Name
|
Type
|
Description
|
filename
|
String
|
파일명
|
link
|
String
|
링크
|
content
|
String
|
내용
|
-
Name
|
Type
|
Description
|
code
|
Integer
|
HTTP 응답코드
|
success
|
Boolean
|
요청 성공 여부
|
message
|
String
|
요청 응답메시지
|
cURL 요청 예제
curl -X GET -H "Accept: application/json" https://api.koreassl.com/v1/order/list?token={토큰}
응답 예제
{
"data": {
"count": 1,
"certs": [
{
"order_type": "new",
"order_id": "O-DZB-411-11123",
"order_code": "334bda9f92a14c1fed4ba9feeb0013912",
"ca": "GoGetSSL",
"product": "Domain SSL",
"product_cate": "single",
"validation_method": "DV",
"period": 12,
"san": 0,
"csr_code": "-----BEGIN CERTIFICATE REQUEST-----\n1IIC2....\n-----END CERTIFICATE REQUEST-----\n",
"crt_code": null,
"ca_code": null,
"key_code": null,
"domain": "example.com",
"domains": null,
"dcv": "dns",
"dcv_email": null,
"dcv_http_link": null,
"dcv_http_filename": null,
"dcv_http_content": null,
"dcv_dns_record": "_F956BDBB0458111AA7CE5662F1C9679E.example.com CNAME A4335B023E9E1492B7548D3544DD1133.5248FDF1C1A596AE7D4C30E0A88B8D5E.t1234584001432312353.comodoca.com",
"dcv_status": "1",
"san_dcv_req": null,
"san_dcv_res": [],
"valid_from": null,
"valid_till": null,
"valid_till_total": null,
"admin_firstname": "Hong",
"admin_lastname": "Gildong",
"admin_email": "support@koreassl.com",
"admin_phone": "01000000000",
"admin_title": "Manager",
"admin_city": "MapoGu",
"admin_address": "130, Test-ro",
"admin_state": "Seoul",
"admin_zipcode": "01022",
"admin_country": "KR",
"admin_organization": "Example",
"tech_firstname": "Hong",
"tech_lastname": "Gildong",
"tech_email": "support@koreassl.com",
"tech_phone": "01000000000",
"tech_title": "Manager",
"tech_city": "MapoGu",
"tech_address": "130, Test-ro",
"tech_state": "Seoul",
"tech_zipcode": "01022",
"tech_country": "KR",
"tech_organization": "Example",
"company_organization": null,
"company_department": null,
"company_duns": null,
"company_lei": null,
"company_phone": null,
"company_city": null,
"company_state": null,
"company_zipcode": null,
"company_address": null,
"company_country": null,
"booking_yn": "Y",
"booking_dt": "2020-09-01",
"status": "processing"
"issue_dt": null,
"reg_dt": "2021-07-29 17:40:14.0"
}
]
},
"status": {
"code": 200,
"success": true,
"message": "success"
}
}
주문 상태
GET /v1/order/status
주문한 인증서 상태 조회
Header
Parameter
Response
-
Name
|
Type
|
Description
|
remarks
|
order_type
|
String
|
주문종류
|
NULL: 주문전 / new: 신규 / renew: 갱신
|
order_id
|
String
|
주문ID (고객지원용)
|
|
order_code
|
String
|
주문코드
|
|
ca
|
String
|
인증기관
|
|
product
|
String
|
제품명
|
|
product_cate
|
String
|
제품종류
|
single / multi / wildcard / multi-wildcard
|
validation_method
|
String
|
검증
|
DV / OV / EV
|
period
|
Integer
|
기간 (개월)
|
3 / 12 / 24 / 36 / 48 / 60 / 72
|
san
|
Integer
|
SAN 추가 개수 (추가도메인)
|
0: 추가없음
|
csr_code
|
String
|
CSR 코드
|
NULL: 주문전
|
crt_code
|
String
|
CRT 코드
|
NULL: 발급전
|
ca_code
|
String
|
CA 코드
|
NULL: 발급전
|
key_code
|
String
|
Key 코드
|
NULL: 주문전 / CSR 직접생성
|
domain
|
String
|
도메인
|
NULL: 주문전
|
domains
|
String
|
추가 도메인
|
NULL: 주문전 또는 추가없음
|
dcv
|
String
|
DCV
|
NULL: 주문전 / email / dns / http / https
|
dcv_email
|
String
|
DCV Email
|
NULL: DCV 인증이 email이 아닐 경우
|
dcv_http_link
|
String
|
DCV http/https link
|
NULL: DCV 인증전 (주문진행중)
|
dcv_http_filename
|
String
|
DCV http/https filename
|
NULL: DCV 인증전 (주문진행중)
|
dcv_http_content
|
String
|
DCV http/https content
|
NULL: DCV 인증전 (주문진행중)
|
dcv_dns_record
|
String
|
DCV DNS record
|
NULL: DCV 인증전 (주문진행중)
|
dcv_status
|
String
|
Common name (도메인) DCV 인증상태
|
1: 인증전 / 2: 인증됨
|
san_dcv_req
|
String
|
멀티도메인 | 멀티와일드에 해당
SAN 도메인별 DCV (Common name을 제외한 DCV: abc@abc.com, dns, ...)
|
NULL: SAN 도메인별 DCV 인증전 (주문진행중)
|
san_dcv_res
|
san_dcv_res[]
|
멀티도메인 | 멀티와일드에 해당
SAN DCV 요청결과
|
NULL: SAN 도메인별 DCV 인증전 (주문진행중)
|
valid_from
|
String
|
인증서 유효기간 시작일
|
NULL: 발급전
|
valid_till
|
String
|
인증서 유효기간 종료일
|
NULL: 발급전
|
valid_till_total
|
String
|
인증서 유효기간 최종 종료일(다년)
|
NULL: 발급전
|
admin_firstname
|
String
|
관리자 이름
|
NULL: 주문전
|
admin_lastname
|
String
|
관리자 성
|
NULL: 주문전
|
admin_email
|
String
|
관리자 이메일
|
NULL: 주문전
|
admin_phone
|
String
|
관리자 연락처
|
NULL: 주문전
|
admin_title
|
String
|
관리자 직급
|
NULL: 주문전
|
admin_city
|
String
|
관리자 주소 (시)
|
NULL: 주문전
|
admin_address
|
String
|
관리자 상세주소
|
NULL: 주문전
|
admin_state
|
String
|
관리자 주소 (도)
|
NULL: 주문전
|
admin_zipcode
|
String
|
관리자 우편번호
|
NULL: 주문전
|
admin_country
|
String
|
관리자 국가코드
|
NULL: 주문전
|
admin_organization
|
String
|
관리자 회사
|
NULL: 주문전
|
tech_firstname
|
String
|
기술자 이름
|
NULL: 주문전
|
tech_lastname
|
String
|
기술자 성
|
NULL: 주문전
|
tech_email
|
String
|
기술자 이메일
|
NULL: 주문전
|
tech_phone
|
String
|
기술자 연락처
|
NULL: 주문전
|
tech_title
|
String
|
기술자 직급
|
NULL: 주문전
|
tech_city
|
String
|
기술자 주소 (시)
|
NULL: 주문전
|
tech_address
|
String
|
기술자 상세주소
|
NULL: 주문전
|
tech_state
|
String
|
기술자 주소 (도)
|
NULL: 주문전
|
tech_zipcode
|
String
|
기술자 우편번호
|
NULL: 주문전
|
tech_country
|
String
|
기술자 국가코드
|
NULL: 주문전
|
tech_organization
|
String
|
기술자 회사
|
NULL: 주문전
|
company_organization
|
String
|
회사명
|
NULL: 주문전
|
company_department
|
String
|
회사 부서
|
NULL: 주문전
|
company_duns
|
String
|
회사 DUNS Number
|
NULL: 주문전
|
company_lei
|
String
|
회사 LEI코드
|
NULL: 주문전
|
company_phone
|
String
|
회사 전화번호
|
NULL: 주문전
|
company_city
|
String
|
회사 주소 (시)
|
NULL: 주문전
|
company_state
|
String
|
회사 주소 (도)
|
NULL: 주문전
|
company_zipcode
|
String
|
회사 우편번호
|
NULL: 주문전
|
company_address
|
String
|
회사 상세주소
|
NULL: 주문전
|
company_country
|
String
|
회사 국가코드
|
NULL: 주문전
|
booking_yn
|
String
|
예약 여부
|
Y: 예약 / N: 즉시발급
|
booking_dt
|
String
|
발급 예약일
|
NULL: 즉시발급
|
status
|
String
|
상태
|
active
/
ready
/
processing
/
pending
/
cancelled
/
failed
/
expired
/
hold
/
rejected
/
incomplete
|
-
Name
|
Type
|
Description
|
status_description
|
String
|
SAN DCV 상태
|
san_name
|
String
|
SAN 도메인 명
|
validation_method
|
String
|
검증
|
validation
|
http
|
검증결과
|
status
|
String
|
검증상태
|
-
Name
|
Type
|
Description
|
filename
|
String
|
파일명
|
link
|
String
|
링크
|
content
|
String
|
내용
|
-
Name
|
Type
|
Description
|
code
|
Integer
|
HTTP 응답코드
|
success
|
Boolean
|
요청 성공 여부
|
message
|
String
|
요청 응답메시지
|
cURL 요청 예제
curl -X GET -H "Accept: application/json" https://api.koreassl.com/v1/order/status?token={토큰}&order_code={주문코드}
응답 예제
{
"data":{
"order_type": "new",
"order_id": "O-DZB-411-11123",
"order_code": "334bda9f92a14c1fed4ba9feeb0013912",
"ca": "GoGetSSL",
"product": "Domain SSL",
"product_cate": "single",
"validation_method": "DV",
"period": 12,
"san": 0,
"csr_code": "-----BEGIN CERTIFICATE REQUEST-----\n1IIC2....\n-----END CERTIFICATE REQUEST-----\n",
"crt_code": null,
"ca_code": null,
"key_code": null,
"domain": "example.com",
"domains": null,
"dcv": "dns",
"dcv_email": null,
"dcv_http_link": null,
"dcv_http_filename": null,
"dcv_http_content": null,
"dcv_dns_record": "_F956BDBB0458111AA7CE5662F1C9679E.example.com CNAME A4335B023E9E1492B7548D3544DD1133.5248FDF1C1A596AE7D4C30E0A88B8D5E.t1234584001432312353.comodoca.com",
"dcv_status": "1",
"san_dcv_req": null,
"san_dcv_res": [],
"valid_from": null,
"valid_till": null,
"valid_till_total": null,
"admin_firstname": "Hong",
"admin_lastname": "Gildong",
"admin_email": "support@koreassl.com",
"admin_phone": "01000000000",
"admin_title": "Manager",
"admin_city": "MapoGu",
"admin_address": "130, Test-ro",
"admin_state": "Seoul",
"admin_zipcode": "01022",
"admin_country": "KR",
"admin_organization": "Example",
"tech_firstname": "Hong",
"tech_lastname": "Gildong",
"tech_email": "support@koreassl.com",
"tech_phone": "01000000000",
"tech_title": "Manager",
"tech_city": "MapoGu",
"tech_address": "130, Test-ro",
"tech_state": "Seoul",
"tech_zipcode": "01022",
"tech_country": "KR",
"tech_organization": "Example",
"company_organization": null,
"company_department": null,
"company_duns": null,
"company_lei": null,
"company_phone": null,
"company_city": null,
"company_state": null,
"company_zipcode": null,
"company_address": null,
"company_country": null,
"booking_yn": "Y",
"booking_dt": "2020-09-01",
"status": "processing"
"issue_dt": null,
"reg_dt": "2021-07-29 17:40:14.0"
},
"status":{
"code": 200,
"success": true,
"message": "success"
}
}
주문 취소
POST /v1/order/cancel
주문 인증서의 취소(취소 및 환불은 정책에 따라 진행)
Header
Parameter
- 토큰 / 필수
- 주문코드 / 필수
* token 항목은
토큰 발급을 참조해주세요.
Response
-
Name
|
Type
|
Description
|
order_code
|
String
|
취소된 주문코드
|
-
Name
|
Type
|
Description
|
code
|
Integer
|
HTTP 응답코드
|
success
|
Boolean
|
요청 성공 여부
|
message
|
String
|
요청 응답메시지
|
cURL 요청 예제
curl -X POST -H "Accept: application/json" -d 'token={토큰}&order_code={주문코드}' https://api.koreassl.com/v1/order/cancel
응답 예제
{
"data":{
"order_code": "6af92ba9ec89698c6bbef3daa85a0000"
},
"status":{
"code": 200,
"success": true,
"message": "success"
}
}
계정 정보
GET /v1/account
계정 정보 조회
Header
Parameter
- 필수
* token 항목은
토큰 발급을 참조해주세요.
Response
-
Name
|
Type
|
Description
|
username
|
String
|
아이디
|
fullname
|
String
|
성명
|
phone
|
String
|
전화번호
|
balance
|
Integer
|
남은 예치금
|
auto_paylater_yn
|
String
|
후불결제 가능 여부 (Y: 후불 가능 / N: 후불 불가능)
|
last_access_dt
|
String
|
최근 접속일
|
reg_dt
|
String
|
가입일
|
-
Name
|
Type
|
Description
|
code
|
Integer
|
HTTP 응답코드
|
success
|
Boolean
|
요청 성공 여부
|
message
|
String
|
요청 응답메시지
|
cURL 요청 예제
curl -X GET -H "Accept: application/json" https://api.koreassl.com/v1/account?token={토큰}
응답 예제
{
"data":{
"username": "hong@koreassl.com",
"fullname": "홍길동",
"phone": "01000000000",
"balance": 7930,
"auto_paylater_yn": "Y",
"last_access_dt": "2020-03-01 18:06:37.0",
"reg_dt": "2020-02-03 11:44:59.0"
},
"status":{
"code": 200,
"success": true,
"message": "success"
}
}
예치금
GET /v1/account/balance
계정의 예치금 잔액 조회
Header
Parameter
- 필수
* token 항목은
토큰 발급을 참조해주세요.
Response
-
Name
|
Type
|
Description
|
balance
|
Integer
|
예치금 잔액 (원)
|
-
Name
|
Type
|
Description
|
code
|
Integer
|
HTTP 응답코드
|
success
|
Boolean
|
요청 성공 여부
|
message
|
String
|
요청 응답메시지
|
cURL 요청 예제
curl -X GET -H "Accept: application/json" https://api.koreassl.com/v1/account/balance?token={토큰}
응답 예제
{
"data":{
"balance": 254850
},
"status":{
"code": 200,
"success": true,
"message": "success"
}
}