錯誤

傳回 HTTP 狀態碼和錯誤訊息時發生錯誤。用戶端傳回 4xx Client Error (4xx 用戶端錯誤誤) 狀態碼造成昏錯誤。API 服務傳回 5xx Server Error (伺服器錯誤) 狀態碼造成昏錯誤。

錯誤回應範例

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|訂單 找不到指定的訂單。
請確定:
  • SSL/TLS 憑證訂單 ID 正確。
  • SSL/TLS 憑證已移轉到您的 CertCentral 帳戶。
如需更多資訊,請參閱您需要知道的與網域和憑證移轉有關的事項
404 not_found|產品 找不到指定的產品。確定您正使用正確的產品識別碼。
請參閱詞彙 — 產品識別碼
404 not_found|路徑 端點不存在。確定您正使用的端點 URL 是正確的。
403 access_denied|missing_permission 您正使用的 API 金鑰沒有執行要求的權限。傳送 GET 要求到 /user/me 端點,然後尋找 access_roles.name 值以識別金鑰的授權等級。
400 ambiguous_product product.type_hint 值無法用於決定產品。
請參閱提交訂單 — 要求參數表
400 auth_key_exists_for_account 已建立用於您的帳戶的驗證金鑰。
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 指定的使用者名稱無法使用。