すべてのプロダクト
Search
ドキュメントセンター

ID Verification:同期呼び出し - CREDENTIAL_RECOGNITION

最終更新日:Jun 30, 2026

CredentialRecognition API を呼び出して、認証情報画像からキー情報を抽出し、偽造を検出します。この同期呼び出しは、結果を即時に返します。

API情報

  • API オペレーション名: CredentialRecognition

  • 説明: AI を使用して認証情報画像からキー情報を抽出し、偽造を検出します。

  • リクエストメソッド: POST

  • プロトコル: HTTPS

  • QPS 制限:各 API には専用の QPS 制限があります。詳細は、「ID Verification サーバー側 API の QPS 制限」をご参照ください。

  • エンドポイント:

    説明
    • 内部ネットワークアクセスのメリット:内部ネットワークを使用すると、同じリージョン内の Alibaba Cloud サービス間でプライベートな通信が可能になります。ご利用のアプリケーションサーバーも同じリージョンにある場合は、内部ネットワークエンドポイントを使用して ID Verification サービスにアクセスすることで、より安全で安定した接続が実現します。

    • 海外アクセスの最適化:中国本土以外のネットワーク環境は複雑な場合があります。遅延を減らし、リクエストの失敗を最小限に抑えるには、「サーバー側のネットワーク遅延分析と最適化」のベストプラクティスに従って統合を最適化してください。

    Singapore

    • パブリックエンドポイント:cloudauth-intl.ap-southeast-1.aliyuncs.com

    • 内部エンドポイント:cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

説明
  1. 認証情報の偽造検出は AI ベースで、内部テストデータセットで90%の精度を達成します。実際の精度はサンプルシナリオによって異なる場合があります。

  2. デジタル合成やソフトウェアで編集された画像よりも、カメラで直接撮影された画像の方が検出効果は高くなります。

  3. 偽造検出を唯一の検証方法として使用しないでください。手動レビューの効率を向上させるための補助ツールとして使用してください。

  4. 偽造検出は、金融決済サービスの利用申込やEコマースの加盟店オンボーディングなどの電子文書レビューシナリオに適用されます。その他のシナリオについては、アカウントマネージャーにお問い合わせください。

オンラインデバッグと統合

説明

デバッグまたは統合を行う前に、「OpenAPI を使用したサーバー側 API のデバッグと統合」ガイドを読み、OpenAPI プラットフォームでの API の呼び出し方法と SDK の取得方法を理解してください。

この操作は OpenAPI Explorer で直接デバッグでき、この操作の SDKサンプルコードを生成できます。

リクエストパラメーター

CredentialOcrPictureBase64 または CredentialOcrPictureUrl パラメーター用の画像は、以下の要件を満たす必要があります:

  • 画像形式: PNG、JPG、JPEG、BMP、WebP。

  • 画像の寸法:幅と高さはそれぞれ 15 ピクセルを超え、8192 ピクセル未満である必要があります。アスペクト比は 50 未満である必要があります。

    説明

    最適な結果を得るには、幅と高さが 500 ピクセルを超える画像を使用してください。

  • 画像サイズ: CredentialOcrPictureUrl の場合は最大 10 MBCredentialOcrPictureBase64 の場合は最大 3 MB

    説明

    画像が大きいとレスポンスタイムが長くなります。可能な場合は 3 MB 未満の画像を使用してください。

名前

タイプ

必須

説明

ProductCode

string

はい

値は CREDENTIAL_RECOGNITION に固定されています。

CREDENTIAL_RECOGNITION

CredentialOcrPictureBase64

string

いいえ

Base64 でエンコードされた画像。エンコードする前に画像サイズを確認してください。

-

CredentialOcrPictureUrl

string

いいえ

一般公開されている画像の HTTP または HTTPS URL。

https://***

DocType

string

はい

認証情報の種類:

  • 01: 水道、電気、ガス、クレジットカードの請求書などの電子請求書を含む取引レシート。

  • 03: 振込の取引記録。

01

OcrArea

string

はい

抽出タイプ:

  • 0101: インテリジェントな分析を通じて電子請求書から抽出された住所と名前。

  • 0301: 振込の取引記録からの金額。

0101

FraudCheck

string

はい

改ざん検出を有効にするかどうか。

  • true: 有効化

  • false: 無効化

true

レスポンスパラメーター

名前

タイプ

説明

HTTPステータスコード

integer

HTTPステータスコード。

200

HTTPボディ

RequestId

string

リクエスト ID。

130A2C10-B9EE-4D84-88E3-5384FF039****

Result.TransactionId

string

一意のトランザクション ID。

hksb7ba1b28130d24e015d694361b****

Code

string

リターンコード: 詳細については、「サーバーサイドHTTPステータスコード」をご参照ください。

重要
  • 呼び出しが成功したかどうかを示します。

  • 検証結果については、ResultObjectフィールドを確認してください。

Success

Message

string

レスポンスメッセージ。

success

Result.Success

string

抽出結果:

  • S: 成功

  • F: 失敗

S

Result.SubCode

string

検証結果の説明。「ResultObject.SubCode エラーコード」をご参照ください。

200

Result.ExtIdInfo

string

例に示すJSON形式。「Result.ExtIdInfo」をご参照ください。

  • OcrArea リクエストパラメーターが 0101 に設定されている場合:

    {
      // 改ざん検出が有効な場合 (FraudCheck = true)、spoofInfo が返されます。
      "spoofInfo":
      {
        "spoofResult": "Y",
        "spoofType": ["PS", "SCREEN_PHOTO", "ORIGINAL_PHOTO"]
      },
      "recInfo":
      {
        "address": "浙江省杭州市蕭山区盈豊街道***",
        "name": "田中一郎"
      }
    }
  • OcrArea リクエストパラメーターが 0301 に設定されている場合:

    {
      // 改ざん検出が有効な場合 (FraudCheck = true)、spoofInfo が返されます。
      "spoofInfo":
      {
        "spoofResult": "Y",
        "spoofType": ["PS", "SCREEN_PHOTO", "ORIGINAL_PHOTO"]
      },
      "recInfo":
      {
        "money": "$41.41"
      }
    }

ResultObject.SubCode エラーコード

エラーコード

課金対象

説明と提案

200

はい

抽出に成功しました。

213

はい

テキストを抽出できませんでした。

Result.ExtIdInfo

名前

タイプ

説明

recInfo

string

抽出されたキー情報。

説明

抽出に失敗した場合、このフィールドは空になります。

  • OcrArea リクエストパラメーターが 0101 に設定されている場合:

    {
      "address": "浙江省杭州市蕭山区盈豊街道、***",
      "name": "田中一郎"
    }
  • OcrArea リクエストパラメーターが 0301 に設定されている場合:

    {
      "money": "$41.41"
    }

spoofInfo

string

認証情報のなりすまし防止チェック結果。リスクアセスメントとリスクタイプが含まれます:

  • spoofResult

    • Y: リスク検出

    • N: 正常

  • spoofType

    • PS: 画像はソフトウェアで編集されています。

    • SCREEN_PHOTO: 画像は画面を撮影したものです。

    • SCREENSHOT: 画像はスクリーンショットです。

    • ORIGINAL_PHOTO: 画像は元の画像ではありません。

改ざん検出が有効化されている (FraudCheck が true に設定されている) 場合に返されます。

{
  "spoofResult": "Y",
  "spoofType": [
    "PS"
  ]
}