証明書の失効

エンドポイント PUT /mpki/api/v1/certificate/{serial_number}/revoke

次の例は、1 つの証明書を失効させるリクエストを示しています。

curl -X PUT "https://one.digicert.com/mpki/api/v1/certificate/07A2xxxxxxx8C/revoke" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: {{api_key}}" \
  -d '{
        "revocation_reason": "key_compromise",
      }'

以下のレスポンスの例は、証明書 07A2xxxxxxx8C が正常に失効したことを示しています。

{
  "serial_number": "07A2xxxxxxx8C",
  "revoked": true,
  "revocation_reason": "key_compromise",
  "revoke_date": "2025-10-20T14:32:10Z"
}

エンドポイントPUT /mpki/api/v1/certificate/{serial_number}/revoke

API を使用して複数の証明書を失効させるには、各証明書のシリアル番号ごとに個別にエンドポイントを呼び出すカスタムスクリプトを作成します。次の例は、3 つの証明書を失効させるリクエストを示しています。

for serial in "07A2xxxxxxx8C" "09B1xxxxxxx5F" "0AF8xxxxxxx4B"
do
  curl -X PUT "https://one.digicert.com/mpki/api/v1/certificate/${serial}/revoke" \
    -H "Content-Type: application/json" \
    -H "X-API-Key: {{api_key}}" \
    -d '{
          "revocation_reason": "cessation_of_operation"
        }'
done

このカスタムスクリプトは一度に 1 つの証明書を失効させ、個別の成功応答を返します。以下のレスポンスの例は、証明書 09B1xxxxxxx5F が正常に失効したことを示しています。

{
  "serial_number": "09B1xxxxxxx5F",
  "revoked": true,
  "revocation_reason": "cessation_of_operation",
  "revoke_date": "2025-10-20T14:34:22Z"
}