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

ID Verification:同期呼び出し - CREDENTIAL_RECOGNITION

最終更新日:Dec 10, 2025

このトピックでは、Credential Recognition API 操作について説明します。この操作は、AI を使用して証明書画像からキー情報を抽出し、偽造を検出します。これは同期呼び出しであり、操作が完了するとすぐに結果が返されます。

API 情報

  • API 操作名: CredentialRecognition

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

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

  • プロトコル: HTTPS

  • 各 API 操作には、専用の 1 秒あたりのクエリ数 (QPS) 制限が適用されます。詳細については、「ID Verification サーバーサイド API 操作の QPS 制限」をご参照ください。

  • エンドポイント:

    説明

    内部ネットワークは、同じリージョン内の Alibaba Cloud プロダクト間のプライベート通信ネットワークです。ご利用のサービスサーバーがサポートされている Alibaba Cloud リージョンにデプロイされている場合、VPC エンドポイントを介して ID Verification サービスにアクセスすることで、より安全で安定したネットワーク通信が可能になります。

    シンガポール

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

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

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

  2. ソフトウェアで編集されたようなデジタル合成画像の改ざんを検出することは困難です。検出は、デジタル合成画像よりもネイティブカメラで撮影された画像の方が効果的です。

  3. 偽造検出を証明書の信頼性を検証する唯一の手段として使用しないでください。レビューの補助ツールとして、または手動レビューの効率を向上させるために使用してください。

  4. 偽造検出は、金融決済の取得や e コマースマーチャントのオンボーディングなどの電子ドキュメントレビューシナリオで広く使用され、手動レビューの効率を向上させます。他のシナリオでこの機能が必要な場合は、アカウントマネージャーにご連絡ください。

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

説明

サーバーサイド API をデバッグして統合する前に、「OpenAPI Explorer を使用したサーバーサイド API 操作のデバッグと統合」ドキュメントを読んで、API 操作の呼び出し方法、および OpenAPI Explorer で SDK とサンプルコードを取得する方法を理解していることを確認してください。

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

リクエストパラメーター

CredentialOcrPictureBase64 または CredentialOcrPictureUrl パラメーターに指定する画像は、次の要件を満たす必要があります:

  • 画像フォーマット: PNG、JPG、JPEG、BMP、WebP。

  • 画像ディメンション: 幅と高さはそれぞれ 15 ピクセルより大きく8192 ピクセル未満である必要があります。アスペクト比は 50 未満である必要があります。

    説明

    最適な結果を得るには、画像の幅と高さの両方が 500 ピクセルより大きいことを推奨します。

  • 画像サイズ: CredentialOcrPictureUrl パラメーターを使用する場合、画像は 10 MB を超えることはできません。CredentialOcrPictureBase64 パラメーターを使用する場合、3 MB を超えることはできません。

    説明

    大きな画像は応答時間を増加させる可能性があります。3 MB 未満の画像を使用することを推奨します。

名前

タイプ

必須

説明

ProductCode

string

はい

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

CREDENTIAL_RECOGNITION

CredentialOcrPictureBase64

string

いいえ

Base64 エンコードされた画像。このメソッドを使用する場合は、画像サイズが大きすぎないことを確認してください。

-

CredentialOcrPictureUrl

string

いいえ

画像の URL。URL は、パブリックネットワークからアクセス可能な HTTP または HTTPS リンクである必要があります。

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

リターンコード

重要
  • このパラメーターは、操作が正常に呼び出されたかどうかを示します。リターンコードの詳細については、「エラーコード」をご参照ください。

  • ビジネス検証結果については、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"
      }
    }

リターンコード

HTTP ステータスコード

コード

メッセージの説明

200

Success

リクエストは成功しました。

400

MissingParameter

パラメーターが空です。

400

InvalidParameter

パラメーターが無効です。

403

Forbidden.RAMUserAccessDenied

RAM ユーザーには AliyunAntCloudAuthFullAccess 権限を付与する必要があります。詳細については、「RAM ユーザーへのサービスアクセス権限の付与」をご参照ください。

403

Forbidden.AccountAccessDenied

アカウントに支払い遅延があります。アカウントに資金を追加してから、もう一度お試しください。

403

Throttling.Api

リクエストは API 速度制限によってブロックされています。

500

InternalError

内部システムエラーが発生しました。トラブルシューティングについては、エンジニアにお問い合わせください。

ResultObject.SubCode エラーコード

エラーコード

課金対象

説明と提案

200

はい

抽出に成功しました。

213

はい

テキストは抽出されませんでした。

Result.ExtIdInfo

名前

タイプ

説明

recInfo

String

抽出されたキー情報。

説明

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

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

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

    {
      "money": "$41.41"
    }

spoofInfo

String

証明書のなりすまし防止チェックの結果。これには、リスク評価結果とリスクタイプが含まれます:

  • spoofResult

    • Y: リスクを検出

    • N: 正常

  • spoofType

    • PS: 画像はソフトウェアで編集されました。

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

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

    • ORIGINAL_PHOTO: 画像はオリジナルではありません。

この結果は、改ざん検出が有効な場合 (リクエストパラメーター FraudCheck が true に設定されている場合) に返されます。

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