錯誤

傳回 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 提供的隨機值相符。如需更多資訊：使用 HTTP 現實論證來證明對網域擁有控制權。一般錯誤：HTTP 現實論證 DCV 方法。
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	指定的使用者名稱無法使用。

錯誤回應範例

回應參數

4Xx 用戶端錯誤碼

關於