소개

개요

  • https://api.koreassl.com
  • https://www.koreassl.com/my 접속 > 로그인 > 파트너 > 파트너연동 목록에서 상용키 또는 개발키를 복사하여 사용
  • https://www.koreassl.com/my 접속 > 로그인 > 파트너 > 파트너연동 편집에서 '허용 IP주소'를 등록

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

  • 필수
  • * apikey: 코리아SSL > 로그인 > 파트너 > 파트너연동 에서 발급 가능

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

  • 필수
  • 인증기관 / 선택
  • * apikey: 코리아SSL > 로그인 > 파트너 > 파트너연동 에서 발급 가능
    * ca: gogetssl | sectigo | digicert | symantec | thawte | geotrust | rapidssl | globalsign | entrust | certum | koreassl 중 하나만 선택가능하며 대소문자를 구분하지 않습니다.

Response

  • Name Type Description
    token String 인증이 필요한 요청에서 사용하는 토큰
    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

  • 필수
  • * token 항목은 토큰 발급을 참조해주세요.

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..~:제한)
  • 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
			},
			  {
				"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
			},
			  {
				"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
			},
			...
		],
	},
	"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)
    자동생성여부 / 필수 / (Y)
    Common name(도메인)명 / 필수
    영문 회사명 / 필수
    영문 부서명 / 필수
    영문 국가코드(2자) / 필수 / (예 KR)
    영문 도 / 필수
    영문 시 / 필수
    이메일주소 / 필수
    선택 / (기본 2048bit)
    계정의 이메일주소로 CSR 메일 전송 / 필수 (입력하실값: Y|N)
  • 관리자 영문 회사명 / 필수 / (예 DEEPACT Inc.)
    관리자 영문 성 / 필수
    관리자 영문 이름 / 필수
    관리자 이메일주소 / 필수
    관리자 연락처(숫자만) / 필수 / (예 82216444308)
    관리자 영문 직급 / 필수 / (예 CEO)
    관리자 영문 시 / 필수 / (예 Seoul)
    관리자 영문 도 / 필수 / (예 None)
    관리자 영문 상세주소 / 필수 / (예 161, Yanghwa-ro, Mapo-gu)
    관리자 우편번호(숫자만) / 필수
    관리자 영문 국가코드(2자) / 필수 / (예 KR)
    기술자 영문 회사명 / 필수 / (예 DEEPACT Inc.)
    기술자 영문 성 / 필수
    기술자 영문 이름 / 필수
    기술자 이메일주소 / 필수
    기술자 연락처(숫자만) / 필수 / (예 82216444308)
    기술자 영문 직급 / 필수 / (예 Manager)
    기술자 영문 시 / 필수 / (예 Seoul)
    기술자 영문 도 / 필수 / (예 None)
    기술자 영문 상세주소 / 필수 / (예 161, Yanghwa-ro, Mapo-gu)
    기술자 우편번호(숫자만) / 필수 / (예 03995)
    기술자 영문 국가코드(2자) / 필수 / (예 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"
    }
}

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"
    }
}

인증서 다운로드

POST /v1/cert/download

발급 완료된 인증서를 다운로드

Header

  • 필수

Parameter

  • 토큰 / 필수
  • 주문코드 / 필수
  • 인증서 파일 종류 / 필수 / (입력하실값: csr | crt | ca | key | rsa_key | crt_ca | jks | pfx | haproxy 중 택1)
  • 패스워드 / 파일 종류가 jks, pfx인 경우 필수
  • * token 항목은 토큰 발급을 참조해주세요.
    * 일부 인증서의 경우 다운로드가 불가할 수 있습니다.
    * 보안을 위해 다운로드 링크는 1회 접속 후 또는 해당 요청 1시간 이후 자동 삭제됩니다.

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"
    }
}

주문 내역

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

  • 토큰 / 필수
  • 주문코드 / 필수
  • * order_code는 주문완료시 return 됩니다.

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"
	}
}

DCV 이메일 조회

GET /v1/tools/domainemail

DCV 인증이 가능한 관리자 이메일 조회 (whois)

Header

  • 필수

Parameter

  • 필수
  • 도메인명 / 필수
  • 인증기관 / 필수
  • * token 항목은 토큰 발급을 참조해주세요.
    * domain: 한글도메인의 경우 퓨니코드(Punycode)로 변환후 사용가능합니다.
    * ca: gogetssl | sectigo | digicert | symantec | thawte | geotrust | rapidssl | globalsign | entrust | certum 중 하나만 선택가능하며 대소문자를 구분하지 않습니다.

Response

  • Name Type Description
    emails Array 사용가능한 이메일주소
    ca String 인증기관
  • Name Type Description
    code Integer HTTP 응답코드
    success Boolean 요청 성공 여부
    message String 요청 응답메시지

cURL 요청 예제

curl -X GET -H "Accept: application/json" https://api.koreassl.com/v1/tools/domainemail?token={토큰}&domain={도메인명}&ca={인증기관}

응답 예제

{
	"data":{
		"emails":[
			"deepact@deepact.com",
			"admin@koreassl.com",
			"administrator@koreassl.com",
			"hostmaster@koreassl.com",
			"postmaster@koreassl.com",
			"webmaster@koreassl.com"
		],
		"ca": "sectigo"
	},
	"status":{
		"code": 200,
		"success": true,
		"message": "success"
	}
}

CSR 생성

POST /v1/csr/generate

CSR 생성

Header

  • 필수

Parameter

  • 토큰 / 필수
    도메인 / 필수 / (www.를 생략한 도메인만 입력: domain.tld)
    토큰 / 필수
    도메인 / 필수 / (*.을 생략한 도메인만 입력: www.domain.tld 또는 domain.tld)
    토큰 / 필수
    도메인 / 필수 / (*.을 붙인 도메인만 입력: *.domain.tld)
    토큰 / 필수
    도메인 / 필수 / (*.을 생략한 도메인만 입력: www.domain.tld 또는 domain.tld)
  • 회사(영문) / 필수
  • 부서(영문) / 필수
  • 시(영문) / 필수 / (예 Seoul)
  • 도(영문) / 필수 / (예 None)
  • 국가코드(2자) / 필수 / (예 KR)
  • 이메일주소 / 필수
  • 계정의 이메일주소로 CSR 메일 전송(위에 입력하신 email로는 전송되지 않습니다.) / 필수 / (입력하실값: Y|N)
  • * token 항목은 토큰 발급을 참조해주세요.
    * common_name: 한글도메인의 경우 퓨니코드(Punycode)로 변환후 사용가능합니다.

Response

  • Name Type Description
    csr String CSR
    key String Key
  • Name Type Description
    code Integer HTTP 응답코드
    success Boolean 요청 성공 여부
    message String 요청 응답메시지

cURL 요청 예제

curl -X POST -H "Accept: application/json" -d 'token={토큰}&common_name={도메인}&organization={회사}&organization_unit={부서}&city={시}&state={도}&email={이메일주소}&country={국가코드}&csr_email_yn={이메일 전송여부}' https://api.koreassl.com/v1/tools/csr/generate

응답 예제

{
	"data":{
		"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"
	}
}

CSR 확인

POST /v1/tools/csr/decode

CSR 확인

Header

  • 필수

Parameter

  • 필수
  • CSR / 필수
  • * token 항목은 토큰 발급을 참조해주세요.
    * csr 항목은 URLEncode 후처리가 필요할 수 있습니다.

Response

  • Name Type Description
    CN String 도메인
    O String 회사 (영문)
    OU String 부서명 (영문)
    L String 시 (영문)
    S String 도 (영문)
    C String 국가코드 (2자)
    EMAIL String 이메일주소
  • Name Type Description
    code Integer HTTP 응답코드
    success Boolean 요청 성공 여부
    message String 요청 응답메시지

cURL 요청 예제

curl -X POST -H "Accept: application/json" -d 'token={토큰}&csr={생성한CSR}' https://api.koreassl.com/v1/tools/csr/decode

응답 예제

{
	"data":{
		"CN": "koreassl.com",
		"O": "DEEPACT Inc.",
		"OU": "IT Dev Team",
		"L": "Seoul",
		"S": "None",
		"C": "KR",
		"EMAIL": "support@koreassl.com"
	},
	"status":{
		"code": 200,
		"success": true,
		"message": "success"
	}
}

SSL 설치확인

POST /v1/tools/ssl/check

SSL 설치확인

Header

  • 필수

Parameter

  • 필수
  • 도메인 / 필수
  • * token 항목은 토큰 발급을 참조해주세요.

Response

  • Name Type Description
    isPortOpen Boolean 443 포트 오픈 여부
    san String 인증서의 적용대상이 되는 도메인
    expiryStart String 인증서 시작일시
    expiryEnd String 인증서 종료일시
    revoke Boolean 인증서 활성화 여부
    expiryDay String 인증서 남은 일수
    type String 제품종류 (single / multi / wildcard / multi-wildcard)
    ca String CA (인증기관)
  • Name Type Description
    code Integer HTTP 응답코드
    success Boolean 요청 성공 여부
    message String 요청 응답메시지

cURL 요청 예제

curl -X POST -H "Accept: application/json" -d 'token={토큰}&domain={도메인주소}' https://api.koreassl.com/v1/tools/ssl/check

응답 예제

{
	"data":{
		"san": "www.koreassl.com,koreassl.com",
		"expiryStart": "2021-07-12 09:00:00",
		"revoke": false,
		"expiryEnd": "2022-07-21 08:59:59",
		"isPortOpen": true,
		"expiryDay": "162",
		"type": "single",
		"ca": "digicert",
		"validation": "ev"
	},
	"status":{
		"code": 200,
		"success": true,
		"message": "success"
	}
}

인증서 확인

POST /v1/tools/cert/check

인증서 확인

Header

  • 필수

Parameter

  • 필수
  • CRT 코드 / 필수
  • KEY 코드 / 필수
  • KEY 패스워드 / 선택
  • * token 항목은 토큰 발급을 참조해주세요.
    * crt,key 항목은 URLEncode 처리가 필요할 수 있습니다.

Response

  • Name Type Description
    is_valid Boolean 인증서 유효 여부 (true: 올바른 인증서 / false: 잘못된 인증서)
  • Name Type Description
    code Integer HTTP 응답코드
    success Boolean 요청 성공 여부
    message String 요청 응답메시지

cURL 요청 예제

curl -X POST -H "Accept: application/json" -d 'token={토큰}&crt={CRT코드}&key={KEY코드}' https://api.koreassl.com/v1/tools/cert/check

응답 예제

{
    "data": {
        "is_valid": true
    },
    "status": {
        "code": 200,
        "success": true,
        "message": "success"
    }
}

인증서 포멧변환

POST /v1/tools/convert/cert

인증서 포멧변환

Header

  • 필수

Parameter

  • 필수
  • CRT 코드 / 필수
  • CA 코드 / 필수
  • KEY 코드 / 필수
  • 변환하실 파일 종류 / 필수 (입력하실값: pem-pfx | pem-jks 중 택1)
  • KEY 패스워드 / 필수
  • * token 항목은 토큰 발급을 참조해주세요.
    * crt,ca,key 항목은 URLEncode 처리가 필요할 수 있습니다.
    * 올바른 crt,ca,key 파일에 한하여 포멧변환이 가능합니다.
    * 보안을 위해 다운로드 링크는 1회 접속 후 또는 해당 요청 1시간 이후 자동 삭제됩니다.

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={토큰}&crt={CRT코드}&ca={CA코드}&key={KEY코드}&convert_type={파일종류}&password={패스워드}' https://api.koreassl.com/v1/tools/convert/cert

응답 예제

{
    "data": {
        "link": "https://api.koreassl.com/link/cert/download/B/70ccfccccabbb77e0acf06f5298c0aaa"
    },
    "status": {
        "code": 200,
        "success": true,
        "message": "success"
    }
}

퓨니코드 변환

POST /v1/tools/convert/punycode

퓨니코드 변환

Header

  • 필수

Parameter

  • 필수
  • 한글도메인 / 필수
  • * token 항목은 토큰 발급을 참조해주세요.

Response

  • Name Type Description
    punycode String 퓨니코드 도메인
  • Name Type Description
    code Integer HTTP 응답코드
    success Boolean 요청 성공 여부
    message String 요청 응답메시지

cURL 요청 예제

curl -X POST -H "Accept: application/json" -d 'token={토큰}&domain={도메인}' https://api.koreassl.com/v1/tools/convert/punycode

응답 예제

{
    "data": {
        "punycode": "xn--3e0bx70ccqbuxu.com"
    },
    "status": {
        "code": 200,
        "success": true,
        "message": "success"
    }
}