身分情報および有効期限検証 API 接続説明

​

申請プロセス

📘 完全なドキュメント：身分情報および有効期限検証 API →

​

基本使用

• accept：受け取りたいレスポンス結果の形式。ここでは application/json、つまり JSON 形式を記入します。
• authorization：API を呼び出すためのキー。申請後、直接ドロップダウンから選択できます。

• name：名前。
• id_card：身分証明書番号。
• image_url：処理する顔画像のリンク。
• validity_end：身分証明書の有効期限の終了日、形式：YYYYMMDD、長期の場合は「00000000」で代用；
• validity_begin：身分証明書の有効期限の開始日、形式：YYYYMMDD。
• encryption：オプション、機密フィールドの暗号化パラメータ（暗号文を送信する必要がある場合）。

{
  "result": "0",
  "description": "一致"
}

• result、認証結果コード、料金状況は以下の通りです。
  • 有料結果コード：
    • 0: 名前と身分証明書番号が一致
    • -1: 名前と身分証明書番号が不一致
  • 無料結果コード：
    • -2: 不正な身分証明書番号（長さ、チェックディジットなどが不正）
    • -3: 不正な名前（長さ、形式などが不正）
    • -4: 証明書データベースサービスの異常
    • -5: 証明書データベースにこの身分証明書の記録がない
    • -6: 権威ある照合システムのアップグレード中、後で再試行してください
    • -7: 認証回数が当日の制限を超えました。
• description、ここでの名前と身分証明書番号の検証結果。

curl -X POST 'https://api.acedata.cloud/identity/idcard/check-2e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "***",
  "id_card": "***",
  "validity_begin": "***",
  "validity_end": "***"
}'

import requests

url = "https://api.acedata.cloud/identity/idcard/check-2e"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "name": "***",
    "id_card": "***",
    "validity_begin": "***",
    "validity_end": "***"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​

エラー処理

• 400 token_mismatched：不正なリクエスト、パラメータが不足または無効である可能性があります。
• 400 api_not_implemented：不正なリクエスト、パラメータが不足または無効である可能性があります。
• 401 invalid_token：未承認、無効または不足している承認トークン。
• 429 too_many_requests：リクエストが多すぎます、レート制限を超えました。
• 500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

​

エラー応答の例

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​

結論