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
証明書類の偽造検出は 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 |
IdQuality | string | いいえ | 品質検出を有効にするかどうか。
| Y |
CheckRuleConfig | string | いいえ | フィールド検証ルールの設定 (JSON 文字列形式)。 | |
OcrValueStandard | string | いいえ | OCR 結果の標準化を有効にするかどうか。
| 0 |
OcrTranslation | string | いいえ | 翻訳を有効にするかどうか。
| 0 |
レスポンスパラメーター
名前 | タイプ | 説明 | 例 | |
HTTP ステータスコード | Integer | HTTP ステータスコード。 | 200 | |
HTTP Body | 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 | はい | 抽出に成功しました。 |
204 | はい | キー情報が一致しません。 |
211 | はい | 画像の品質または解像度が要件を満たしていません。画像が鮮明で、露出が適切であり、全体が写っていて遮るものがなく、極端な傾きがないことを確認してください。 |
212 | はい | 偽造検出で脅威が検出されました。これは、画面の再撮影、改ざん、コピーなどのリスクの高い操作が原因である可能性があります。 |
213 | はい | ドキュメントタイプが正しくありません。指定されたドキュメントタイプと一致することを確認してください。 |
Result.ExtIdInfo
名前 | タイプ | 説明 | 例 |
recInfo | String | 抽出されたキー情報。 説明 抽出に失敗した場合、このフィールドは空になります。 |
|
spoofInfo | String | 偽造検出の結果。リスク評価とリスクタイプを含みます:
| 偽造検出が有効な場合 ( |