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
認証情報の偽造検出は AI ベースで、内部テストデータセットで90%の精度を達成します。実際の精度はサンプルシナリオによって異なる場合があります。
デジタル合成やソフトウェアで編集された画像よりも、カメラで直接撮影された画像の方が検出効果は高くなります。
偽造検出を唯一の検証方法として使用しないでください。手動レビューの効率を向上させるための補助ツールとして使用してください。
偽造検出は、金融決済サービスの利用申込やEコマースの加盟店オンボーディングなどの電子文書レビューシナリオに適用されます。その他のシナリオについては、アカウントマネージャーにお問い合わせください。
オンラインデバッグと統合
デバッグまたは統合を行う前に、「OpenAPI を使用したサーバー側 API のデバッグと統合」ガイドを読み、OpenAPI プラットフォームでの API の呼び出し方法と 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 | いいえ | 一般公開されている画像の HTTP または HTTPS URL。 | https://*** |
DocType | string | はい | 認証情報の種類:
| 01 |
OcrArea | string | はい | 抽出タイプ:
| 0101 |
FraudCheck | string | はい | 改ざん検出を有効にするかどうか。
| true |
レスポンスパラメーター
名前 | タイプ | 説明 | 例 | |
HTTPステータスコード | integer | HTTPステータスコード。 | 200 | |
HTTPボディ | RequestId | string | リクエスト ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039**** |
Result.TransactionId | string | 一意のトランザクション ID。 | hksb7ba1b28130d24e015d694361b**** | |
Code | string | リターンコード: 詳細については、「サーバーサイドHTTPステータスコード」をご参照ください。 重要
| Success | |
Message | string | レスポンスメッセージ。 | success | |
Result.Success | string | 抽出結果:
| S | |
Result.SubCode | string | 検証結果の説明。「ResultObject.SubCode エラーコード」をご参照ください。 | 200 | |
Result.ExtIdInfo | string | 例に示すJSON形式。「Result.ExtIdInfo」をご参照ください。 |
| |
ResultObject.SubCode エラーコード
エラーコード | 課金対象 | 説明と提案 |
200 | はい | 抽出に成功しました。 |
213 | はい | テキストを抽出できませんでした。 |
Result.ExtIdInfo
名前 | タイプ | 説明 | 例 |
recInfo | string | 抽出されたキー情報。 説明 抽出に失敗した場合、このフィールドは空になります。 |
|
spoofInfo | string | 認証情報のなりすまし防止チェック結果。リスクアセスメントとリスクタイプが含まれます:
| 改ざん検出が有効化されている ( |