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

ID Verification:同期呼び出し - CREDENTIAL_RECOGNITION

最終更新日:Sep 15, 2026

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

API 情報

  • API 操作名:CredentialRecognitionIntl

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

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

  • プロトコル:HTTPS

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

  • エンドポイント:

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

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

    シンガポール

    • パブリックエンドポイント: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:送金の取引記録。

  • 04:住所証明書。

01

OcrArea

string

はい

抽出タイプ:

  • 0101:電子請求書からの住所と氏名。インテリジェント分析によって抽出されます。

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

  • 0401:住所証明書から抽出された情報。

0101

FraudCheck

string

はい

偽造検出を有効にするかどうか。

  • true: 有効

  • false: 無効

true

IdQuality

string

いいえ

品質検出を有効にするかどうか。

  • Y: 有効

  • N:無効

Y

CheckRuleConfig

string

いいえ

フィールド検証ルールの設定 (JSON 文字列形式)。

{
  "address_rule": "Includes Address Hangzhou***",
  "name_rule": "Includes Name Zhang*",
  "date_of_issue_rule": "Within 2026.05.20"
}

OcrValueStandard

string

いいえ

OCR 結果の標準化を有効にするかどうか。

  • 0:無効

  • 1: 有効化

0

OcrTranslation

string

いいえ

翻訳を有効にするかどうか。

  • 0: 無効

  • 1:有効

0

レスポンスパラメーター

名前

タイプ

説明

HTTP ステータスコード

Integer

HTTP ステータスコード。

200

HTTP Body

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": "Yingfeng Street, Xiaoshan District, Hangzhou, Zhejiang Province***",
        "name": "山田 太郎"
      }
    }
  • OcrArea リクエストパラメーターが 0301 に設定されている場合:

    {
      // 偽造検出が有効な場合 (FraudCheck = true)、spoofInfo が返されます。
      "spoofInfo": {
        "spoofResult": "Y",
        "spoofType": [
          "PS",
          "SCREEN_PHOTO",
          "ORIGINAL_PHOTO"
        ]
      },
      "recInfo": {
        "money": "$41.41"
      }
    }
  • OcrArea リクエストパラメーターが 0401 に設定されている場合:

    {
      "translateInfo": {
        "address_t": "1/176-C China",
        "name_t": "SSS SSS SSS"
      },
      "standardInfo": {
        "date_of_issue_s": "2010-06-05"
      },
      "spoofInfo": {
        "spoofResult": "Y",
        "spoofType": [
          "PS",
          "SCREEN_PHOTO",
          "ORIGINAL_PHOTO"
        ]
      },
      "checkInfo": {
        "address_rule": "Y",
        "date_of_issue_rule": "Y",
        "name_rule": "Y"
      },
      "recInfo": {
        "address": "1/176-C China",
        "date_of_issue": "06/05/2010",
        "name": "SSS SSS SSS"
      }
    }

ResultObject.SubCode エラーコード

エラーコード

課金

説明と提案

200

はい

抽出に成功しました。

204

はい

キー情報が一致しません。

211

はい

画像の品質または解像度が要件を満たしていません。画像が鮮明で、露出が適切であり、全体が写っていて遮るものがなく、極端な傾きがないことを確認してください。

212

はい

偽造検出で脅威が検出されました。これは、画面の再撮影、改ざん、コピーなどのリスクの高い操作が原因である可能性があります。

213

はい

ドキュメントタイプが正しくありません。指定されたドキュメントタイプと一致することを確認してください。

Result.ExtIdInfo

名前

タイプ

説明

recInfo

String

抽出されたキー情報。

説明

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

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

    {
      "address": "Yingfeng Street, Xiaoshan District, Hangzhou, Zhejiang Province, ***",
      "name": "山田 太郎"
    }
  • OcrArea リクエストパラメーターが 0301 に設定されている場合:

    {
      "money": "$41.41"
    }

spoofInfo

String

偽造検出の結果。リスク評価とリスクタイプを含みます:

  • spoofResult

    • Y: リスク検出

    • N:通常

  • spoofType

    • 追伸:この画像はソフトウェアで編集したものです。

    • SCREEN_PHOTO: 画像は画面の写真です。

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

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

偽造検出が有効な場合 (FraudCheck が true に設定されている場合) に返されます。

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