오류

오류는 HTTP 상태 코드 및 오류 메시지를 모두 반환합니다. 클라이언트에 의해 발생한 오류는 4xx 클라이언트 오류 상태 코드를 반환합니다. API 서비스에 의해 발생한 오류는 5xx 서버 오류 상태 코드를 반환합니다.

예제 오류 응답

json
{
  "errors": [
    {
      "code": "<error_code>",
      "message": "<error_message>"
    }
  ]
}

응답 매개 변수

이름 유형 설명
errors array 요청에서 오류의 목록입니다.
.. code string 지정된 오류를 식별하는 오류 코드입니다.
.. message string 오류의 설명입니다.

4xx 클라이언트 오류 코드

상태 코드 설명
429 request_limit_exceeded 서비스를 사용할 수 없습니다. 요청 수를 제한하십시오
속도 제한을 참조하십시오.
404 not_found 일반적 404 메시지입니다. 엔드포인트 URL이 적절하게 구성되었는지 확인하십시오.
404 not_found|order 지정한 주문을 찾을 수 없습니다.
다음을 확인합니다.
  • SSL/TLS 인증서 주문 ID가 정확합니다.
  • SSL/TLS 인증서가 CertCentral 계정으로 마이그레이션되었습니다.
자세한 정보는 도메인 및 인증서 마이그레이션에 대해 알아야 하는 내용을 참조하십시오.
404 not_found|product 지정한 제품을 찾을 수 없습니다. 정확한 제품 식별자를 사용하는지 확인하십시오.
용어집 — 제품 식별자를 참조하십시오.
404 not_found|route 엔드포인트가 없습니다. 사용하는 엔드포인트 URL이 정확한지 확인하십시오.
403 access_denied|missing_permission 사용하는 API 키에 요청을 수행할 권한이 없습니다. 키의 권한 부여 수준을 식별하려면 /user/me 엔드포인트에 GET 요청을 보내어 access_roles.name 값을 찾습니다.
400 ambiguous_product 제품을 결정하기 위해 product.type_hint 값을 사용할 수 없습니다.
주문 제출 — 요청 매개 변수 표를 참조하십시오.
400 auth_key_exists_for_account 계정에 대한 AuthKey를 이미 만들었습니다.
400 bad_request_format 요청 본문의 형식이 틀립니다. 요청 본문이 유효한 JSON 또는 XML을 사용하는지 확인하십시오.
400 cert_transparency_turned_off_for_account CertCentral 계정에 대해 CT 로그를 사용 중지했습니다. 관리자가 이 기능을 사용해야 합니다.
400 csr_invalid_cannot_parse CSR이 정확한 형식이 아니거나 필요한 필드가 없거나 잘못된 글자가 있는 필드를 포함합니다.
CSR 만들기를 참조하십시오.
400 csr_not_allowed 지정된 제품이 CSR을 사용하지 않습니다.
용어집 — CSR 요구 사항을 참조하십시오.
400 ct_logging_disabled CertCentral 계정에 대해 CT 로그를 사용 중지했습니다. 관리자가 이 기능을 사용해야 합니다.
400 custom_expiration_not_allowed 허용된 유효 기간이 제품 유형에 대해 구성되어 있습니다. 제한 사항을 제거하여 사용자 지정 만료 날짜를 허용하십시오.
400 disabled_domain 제출한 도메인이 비활성화되어 있습니다. 제출하기 전에 도메인을 활성화해야 합니다.
도메인 활성화를 참조하십시오.
400 domain_not_allowed 지정된 컨테이너에 대해 도메인 제한이 구성되어 있습니다.
400 email_domain_not_validated 이메일에 검사한 도메인이 있어야 합니다.
400 email_not_valid_email_format 제출한 이메일 주소가 유효하지 않습니다. 제출한 이메일 주소가 표준 이메일 주소 규칙을 따르는지 확인하십시오.
400 file_random_value_not_found 도메인에 대해 예상하는 파일 위치에 무작위 값을 찾을 수 없습니다.
다음을 확인합니다.
  • .txt 파일 이름이 fileauth.txt입니다.
  • fileauth.txt 파일이 .well-known/pki-validation/에 위치합니다.
    예제 URL: http://[yourdomain]/.well-known/pki-validation/fileauth.txt
  • fileauth.txt 파일의 임의 값이 DigiCert에서 제공한 임의 값과 일치합니다.
자세한 정보는
400 inactive_organization 제출한 조직이 비활성화되어 있습니다. 조직을 활성화하거나 다른 조직을 지정하십시오.
조직 활성화를 참조하십시오.
400 internal_names_not_allowed
400 invalid_ca_cert_id 지정된 인증 기관이 유효하지 않습니다.
400 invalid_chars:<param.name> 지정된 매개 변수가 잘못된 글자를 포함합니다. 엔드포인트의 응답 매개 변수 표에서 유효한 입력 글자를 참조하십시오.
400 invalid_common_name_on_duplicate 복제 요청의 일반 이름이 원래 주문과 일치해야 합니다. 원래 주문에서 정확한 일반 이름을 참조하십시오.
400 invalid_dns_cname 도메인에 대한 유효한 DNS CNAME 레코드를 찾을 수 없습니다.
다음을 확인합니다.
  • DNS CNAME 레코드 변경 사항이 적용되어 있습니다.
  • CNAME 레코드의 임의 값이 DigiCert에서 제공한 임의 값과 일치합니다.
  • 대상 호스트 파일(또는 동등한 파일)이 dcv.digicert.com으로 설정되어 있습니다.
자세한 정보는 DNS CNAME 레코드를 사용하여 도메인에 대한 제어 증명을 참조하십시오.
400 invalid_dns_method 주문에 대한 DCV 방법이 이메일로 지정되어 있습니다.
400 invalid_dns_name_on_duplicate 복제 요청의 DNS 이름이 원래 주문과 일치해야 합니다. 원래 주문에서 정확한 DNS 이름을 참조하십시오.
400 invalid_dns_txt 도메인에 대한 유효한 DNS TXT 레코드를 찾을 수 없습니다.
다음을 확인합니다.
  • DNS TXT 레코드 변경 사항이 적용되어 있습니다.
  • TXT 레코드의 임의 값이 DigiCert에서 제공한 임의 값과 일치합니다.
자세한 정보는 DNS TXT 레코드를 사용하여 도메인에 대한 제어 증명을 참조하십시오.
400 invalid_payment_method 지정한 결제 방법이 사용되지 않고 있습니다. 지정한 결제 방법을 사용하려면 계정에서 사용해야 합니다.
400 invalid_value:<param.name> 지정된 매개 변수가 잘못된 값을 포함합니다. 엔드포인트의 응답 매개 변수 표에서 유효한 입력 값을 참조하십시오.
400 missing_ca_cert_id 이 요청에 대한 인증 기관 ID가 필요합니다. 인증서를 발급할 인증 기관을 지정하고 요청을 다시 보내십시오.
400 missing_dns_name_on_duplicate 요청에 DNS 이름이 없습니다. 중복 주문에서 DNS 이름을 제거할 수 없습니다. DNS 이름을 포함하여 요청을 다시 보내십시오.
400 missing_request_data 요청에서 본문을 보내지 않았습니다. 엔드포인트 설명서에서 요청 요구 사항을 참조하십시오.
400 missing_required_custom_field 요청 본문에 필요한 사용자 지정 필드가 없습니다.
계정에 대한 사용자 지정 주문 필드 메타데이터의 목록을 받으려면 사용자 지정 필드 목록을 참조하십시오.
400 no_private_ca_enabled 이 계정에 사용하는 사설 인증 기관이 없습니다.
400 not_allowed_to_change_ct_setting_per_order CertCentral 계정에 인증서 주문 당 기능을 활성화하지 않았습니다. 관리자가 이 기능을 사용해야 합니다.
400 order_not_eligible_for_duplicate 지정한 주문에 대한 복제를 허용하지 않습니다.
400 other_domain_on_wildcard 와일드카드 인증서의 모든 SAN은 같은 일반 이름이 있어야 합니다. SAN을 변경하여 동일한 일반 이름을 사용하거나 멀티도메인 인증서를 주문하십시오.
400 pending_reissue 이 주문에 대한 이전 다시 발급 요청이 아직 보류 중입니다. 새로운 다시 발급을 요청하기 전에 보류 중인 요청을 거부하거나 승인하고 발급해야 합니다.
400 product_name_limit_exceeded 이 제품에 허용된 사용자 수를 초과했습니다.
400 product_not_allowed 이 제품은 허용되지 않습니다.
400 protected_domain 이 인증서 요청에 나열한 한 개 이상의 도메인은 도메인 소유자의 보호를 받습니다. 도메인을 수정하고 요청을 다시 제출하십시오.
400 required_param: 지정한 매개 변수가 필요합니다. 엔드포인트의 응답 매개 변수 표를 참조하여 필수 및 옵션 매개 변수를 식별하십시오.
400 rfc5280_common_name_invalid 제출한 일반 이름이 업계 표준을 준수하지 않습니다.
400 rfc5280_common_name_too_long 일반 이름은 업계 표준을 준수하려면 64자 이하여야 합니다.
400 rfc5280_org_unit_too_long 조직 부서는 업계 표준을 준수하려면 64자 이하여야 합니다.
400 rfc5280_org_name_too_long 조직 이름 총 길이(EV 인증서의 가명을 포함)는 업계 표준을 준수하려면 64자 이하여야 합니다.
400 rfc5280_address_field_too_long 주소 필드는 업계 표준을 준수하려면 64자 이하여야 합니다.
400 rfc5280_org_unit_invalid 조직 부서 필드가 업계 표준에 비하여 잘못된 값을 포함합니다.
400 rfc5280_org_invalid 조직의 한 개 이상 필드에 업계 표준에 비하여 잘못된 값을 포함하고 있습니다.
400 username_unavailable 지정한 사용자 이름을 사용할 수 없습니다.