소개
개요
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
data
Name
Type
Description
token
String
인증이 필요한 요청에서 사용하는 토큰
status
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
data
Name
Type
Description
list
list[]
인증기관 목록
list
Name
Type
Description
ca
String
CA (인증기관)
status
String
CA 발급 서버 상태 (good:정상 / bad:발급지연)
status
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
주문가능한 인증서 목록11
Header
Parameter
Response
data
Name
Type
Description
products
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:주문불가능) 2024. 02. 15 이후 미사용
ip_san_yn
String
서브(SAN) 도메인 Public IP 주문가능여부 (Y:주문가능 | N:주문불가능)
status
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
token 토큰 / 필수 order_type 주문타입 / 필수 / (입력하실값: new |renew 중 택1) pay_type 결제방법 / 필수 / (입력하실값: balance |postpaid |point 중 택1) product_code 제품코드 / 필수 period 인증기간(개월) / 필수 / (입력하실값: 12|24|36|48|60|72 중 택1) booking_yn 예약 발급으로 신청 / 선택 / (입력하실값: Y) booking_dt 예약 발급일 / 선택 또는 필수 / (예약 발급 신청시 필수, 입력하실값: 예: 2020-09-23)
domain 도메인 / 필수 / (한글도메인: 퓨니코드)
domain 도메인 / 필수 / (한글도메인: 퓨니코드)
domains SAN 도메인명(콤마로 구분) / 선택 또는 필수 / (domain을 제외한 추가 도메인만 입력: domain2.com,domain3.com,...)
san 추가 SAN 도메인(숫자) / 선택
domain 도메인 / 필수 / (*.domain.com, 한글도메인: 퓨니코드)
domain 도메인 / 필수 / (*.domain.com, 한글도메인: 퓨니코드)
domains SAN 도메인명(콤마로 구분) / 선택 또는 필수 / (domain을 제외한 추가 도메인만 입력: *.domain2.com,*.domain3.com,...)
san 추가 SAN 도메인(숫자) / 선택
domain IP 주소 / 필수
domains SAN IP(콤마로 구분) / 선택 / (domain을 제외한 추가 도메인만 입력: 142.250.66.142,17.253.144.10,...)
san 추가 SAN 도메인(숫자) / 선택
dcv domain 소유인증 / 필수 / (입력하실값: email)
dcv_email domain 소유인증 이메일주소 / 필수
san_dcv_req SAN 도메인별 DCV(콤마로 구분) / 선택 또는 필수 / (domain을 제외한 추가 Email 입력: support@koreassl.com,manager@koreassl.com...)
dcv domain 소유인증 / 필수 / (입력하실값: dns|http|https 중 택1)
san_dcv_req SAN 도메인별 DCV(콤마로 구분) / 선택 또는 필수 / (domain을 제외한 추가 DCV만 입력: dns,http,...)
csr 직접생성 / 필수
csr_email_yn 계정의 이메일주소로 CSR 메일 전송 / 필수 / (입력하실값: Y|N, auto_csr:Y일 경우에만 발송가능)
auto_csr 자동생성여부 / 필수 / (Y)
csr_common_name Common name(도메인)명 / 필수
csr_organization 영문 회사명 / 필수
csr_department 영문 부서명 / 필수
csr_country 영문 국가코드(2자) / 필수 / (예 KR)
csr_state 영문 도 / 필수
csr_city 영문 시 / 필수
csr_email 이메일주소 / 필수
csr_key_size 선택 / (기본 2048bit)
csr_email_yn 계정의 이메일주소로 CSR 메일 전송 / 필수 (입력하실값: Y|N)
admin_organization 관리자 영문 회사명 / 필수 / (예 DEEPACT Inc.)
admin_lastname 관리자 영문 성 / 필수
admin_firstname 관리자 영문 이름 / 필수
admin_email 관리자 이메일주소 / 필수
admin_phone 관리자 연락처(숫자만) / 필수 / (예 82216444308)
admin_title 관리자 영문 직급 / 필수 / (예 CEO)
admin_city 관리자 영문 시 / 필수 / (예 Seoul)
admin_state 관리자 영문 도 / 필수 / (예 None)
admin_address 관리자 영문 상세주소 / 필수 / (예 161, Yanghwa-ro, Mapo-gu)
admin_zipcode 관리자 우편번호(숫자만) / 필수
admin_country 관리자 영문 국가코드(2자) / 필수 / (예 KR)
admin_to_tech 관리자정보와 기술자정보가 동일 /(기본값:N / 입력하실값: Y|N)
tech_organization 기술자 영문 회사명 / 선택적 필수(admin_to_tech=N) / (예 DEEPACT Inc.)
tech_lastname 기술자 영문 성 / 선택적 필수(admin_to_tech=N)
tech_firstname 기술자 영문 이름 / 선택적 필수(admin_to_tech=N)
tech_email 기술자 이메일주소 / 선택적 필수(admin_to_tech=N)
tech_phone 기술자 연락처(숫자만) / 선택적 필수(admin_to_tech=N) / (예 82216444308)
tech_title 기술자 영문 직급 / 선택적 필수(admin_to_tech=N) / (예 Manager)
tech_city 기술자 영문 시 / 선택적 필수(admin_to_tech=N) / (예 Seoul)
tech_state 기술자 영문 도 / 선택적 필수(admin_to_tech=N) / (예 None)
tech_address 기술자 영문 상세주소 / 선택적 필수(admin_to_tech=N) / (예 161, Yanghwa-ro, Mapo-gu)
tech_zipcode 기술자 우편번호(숫자만) / 선택적 필수(admin_to_tech=N) / (예 03995)
tech_country 기술자 영문 국가코드(2자) / 선택적 필수(admin_to_tech=N) / (예 KR)
admin_organization 관리자 영문 회사명 / 필수 / (예 DEEPACT Inc.)
admin_lastname 관리자 영문 성 / 필수
admin_firstname 관리자 영문 이름 / 필수
admin_email 관리자 이메일주소 / 필수
admin_phone 관리자 연락처(숫자만) / 필수 / (예 82216444308)
admin_title 관리자 영문 직급 / 필수 / (예 CEO)
admin_city 관리자 영문 시 / 필수 / (예 Seoul)
admin_state 관리자 영문 도 / 필수 / (예 None)
admin_address 관리자 영문 상세주소 / 필수 / (예 161, Yanghwa-ro, Mapo-gu)
admin_zipcode 관리자 우편번호(숫자만) / 필수 / (예 03995)
admin_country 관리자 영문 국가코드(2자) / 필수 / (예 KR)
tech_organization 기술자 영문 회사명 / 필수 / (예 DEEPACT Inc.)
tech_lastname 기술자 영문 성 / 필수
tech_firstname 기술자 영문 이름 / 필수
tech_email 기술자 이메일주소 / 필수
tech_phone 기술자 연락처(숫자만) / 필수 / (예 82216444308)
tech_title 기술자 영문 직급 / 필수 / (예 Manager)
tech_city 기술자 영문 시 / 필수 / (예 Seoul)
tech_state 기술자 영문 도 / 필수 / (예 None)
tech_address 기술자 영문 상세주소 / 필수 / (예 161, Yanghwa-ro, Mapo-gu)
tech_zipcode 기술자 우편번호(숫자만) / 필수 / (예 03995)
tech_country 기술자 영문 국가코드(2자) / 필수 / (예 KR)
company_organization 회사 영문 회사명 / 필수 / (예 DEEPACT Inc.)
company_department 회사 영문 부서명 / 필수 / (예 IT Develop)
company_phone 회사 연락처(숫자만) / 필수 / (예 82216444308)
company_city 회사 영문 시 / 필수 / (예 Seoul)
company_state 회사 영문 도 / 필수 / (예 None)
company_address 회사 영문 상세주소 / 필수 / (예 161, Yanghwa-ro, Mapo-gu)
company_zipcode 회사 우편번호(숫자만) / 필수 / (예 03995)
company_country 회사 영문 국가코드(2자) / 필수 / (예 KR)
company_duns 회사 DUNS Number / 선택 help company_lei 회사 LEI Code / 선택 help
* token 항목은
토큰 발급 을 참조해주세요.
* product_code 항목은
제품 을 참조해주세요.
Response
data
Name
Type
Description
order_code
String
주문코드
balance
Integer
예치금 잔액 (원) / 예치금으로 결제시
pay
Integer
지불한 금액 (원)
csr
String
CSR code / S/MIME 제품 제외
key
String
KEY code / S/MIME 제품 제외 / CSR 직접생성시 NULL
status
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
data
Name
Type
Description
link
String
다운로드 링크 (링크 접속시 만료)
status
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
token 토큰 / 필수 order_code 주문코드 / 필수 new_methods 도메인별 DCV(콤마로 구분) / 필수 / (DCV 입력: dns,http,admin@admin.com...) domains 도메인명(콤마로 구분) / 필수 / (도메인 입력: domain2.com,domain3.com,domain4.tld...)
* token 항목은
토큰 발급 을 참조해주세요.
* dcv: email의 경우에는
Whois 에 등록된 이메일을 기재해주셔야 정상적으로 이메일이 전송됩니다.
Response
status
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
token 토큰 / 필수 domain 도메인명 / 선택 (멀티인증서의 경우 추가 도메인 포함 검색) status 상태 / 선택 (입력하실값:
active
/
ready
/
processing
/
pending
/
cancelled
/
failed
/
expired
/
hold
/
rejected
/
incomplete ) booking_yn 예약 발급 / 선택 (입력하실값: Y|N)
Response
data
Name
Type
Description
certs
certs[]
인증서 목록
count
Name
Type
Description
count
int
인증서 개수
certs
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
san_dcv_res
Name
Type
Description
status_description
String
SAN DCV 상태
san_name
String
SAN 도메인 명
validation_method
String
검증
validation
http
검증결과
status
String
검증상태
http
Name
Type
Description
filename
String
파일명
link
String
링크
content
String
내용
status
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
data
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
san_dcv_res
Name
Type
Description
status_description
String
SAN DCV 상태
san_name
String
SAN 도메인 명
validation_method
String
검증
validation
http
검증결과
status
String
검증상태
http
Name
Type
Description
filename
String
파일명
link
String
링크
content
String
내용
status
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 토큰 / 필수 order_code 주문코드 / 필수 * token 항목은
토큰 발급 을 참조해주세요.
Response
data
Name
Type
Description
order_code
String
취소된 주문코드
status
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"
}
}
SAN 추가
POST /v1/san/add
멀티 인증서 SAN 추가 요청
Header
Parameter
token 토큰 / 필수 order_code 주문코드 / 필수 domains SAN 도메인명(콤마로 구분, 최소 1개 또는 다수 입력 가능) / 필수 / (domain2.com,domain3.com...) san_dcv_req SAN 소유인증 수단(콤마로 구분, 최소 1개 또는 다수 입력 가능) / 필수 / (dns,admin@domain3.com...)
* token 항목은
토큰 발급 을 참조해주세요.
* san_dcv_req 항목이 email 형식일 경우 인증기관의 도메인 이메일 목록을 요청하기 때문에 시간이 소요될 수 있습니다.
* domains / san_dcv_req 항목의 개수는 동일해야 합니다.
* SAN 가격은 인증서 발급이 완료된 후 선정 및 결제가 요청 됩니다.
Response
data
Name
Type
Description
order_code
String
주문코드
status
Name
Type
Description
code
Integer
HTTP 응답코드
success
Boolean
요청 성공 여부
message
String
요청 응답메시지
cURL 요청 예제
curl -X POST \
-H "Accept: application/json" \
-d 'token={토큰}' \
-d 'order_code={주문코드}' \
-d 'domains=domain2.com,domain3.com' \
-d 'san_dcv_req=dns,admin@domain3.com' \
https://api.koreassl.com/v1/san/add
응답 예제
{
"data": {
"order_code": "f9d0a96588d42db96316867c58d23466",
},
"status": {
"code": 200,
"success": true,
"message": "success"
}
}
인증서 분실 재발급
POST /v1/order/reissue
인증서 재발급 요청
Header
Parameter
Response
data
Name
Type
Description
order_code
String
주문코드
csr
String
CSR code
key
String
KEY code / CSR 직접생성시 NULL
status
Name
Type
Description
code
Integer
HTTP 응답코드
success
Boolean
요청 성공 여부
message
String
요청 응답메시지
cURL 요청 예제
curl --location --request POST 'https://api.koreassl.com/v1/reissue/add?token={토큰}&order_code={주문코드}&csr_state=None&csr_city=Seoul&csr_email=dev@koreassl.com&dcv=dns&auto_csr=Y&csr_common_name=koreassl.com&csr_organization=KODICA&csr_department=IT%20Team&csr_country=KR'
응답 예제
{
"data":{
"order_code": "bc8c35800a4414647bb19a0e623a6b69",
"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"
}
}
계정 정보
GET /v1/account
계정 정보 조회
Header
Parameter
token 필수 * token 항목은
토큰 발급 을 참조해주세요.
Response
data
Name
Type
Description
username
String
아이디
fullname
String
성명
phone
String
전화번호
balance
Integer
남은 예치금
auto_paylater_yn
String
후불결제 가능 여부 (Y: 후불 가능 / N: 후불 불가능)
last_access_dt
String
최근 접속일
reg_dt
String
가입일
status
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 필수 * token 항목은
토큰 발급 을 참조해주세요.
Response
data
Name
Type
Description
balance
Integer
예치금 잔액 (원)
status
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"
}
}
포인트
GET /v1/account/bonusPoint
계정의 포인트 잔액 조회
Header
Parameter
token 필수 * token 항목은
토큰 발급 을 참조해주세요.
Response
data
Name
Type
Description
point
Integer
포인트 잔액 (원)
status
Name
Type
Description
code
Integer
HTTP 응답코드
success
Boolean
요청 성공 여부
message
String
요청 응답메시지
cURL 요청 예제
curl -X GET -H "Accept: application/json" https://api.koreassl.com/v1/account/bonusPoint?token={토큰}
응답 예제
{
"data":{
"point": 254850
},
"status":{
"code": 200,
"success": true,
"message": "success"
}
}
