このトピックでは、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.comVPC エンドポイント:
cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com
証明書偽造検出機能は AI ベースの予測プロダクトです。内部テストデータセットで 90% の精度を達成しています。実際の精度は、サンプルシナリオの違いにより異なる場合があります。
ソフトウェアで編集されたようなデジタル合成画像の改ざんを検出することは困難です。検出は、デジタル合成画像よりもネイティブカメラで撮影された画像の方が効果的です。
偽造検出を証明書の信頼性を検証する唯一の手段として使用しないでください。レビューの補助ツールとして、または手動レビューの効率を向上させるために使用してください。
偽造検出は、金融決済の取得や 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 |
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 | 重要
| Success | |
Message | String | 応答メッセージ。 | success | |
Result.Success | String | 抽出結果:
| S | |
Result.SubCode | String | 検証結果の説明。詳細については、「ResultObject.SubCode エラーコード」をご参照ください。 | 200 | |
Result.ExtIdInfo | String | JSON フォーマットについては、右側の例をご参照ください。詳細については、「Result.ExtIdInfo」をご参照ください。 |
| |
リターンコード
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 | 抽出されたキー情報。 説明 抽出に失敗した場合、このフィールドは空になります。 |
|
spoofInfo | String | 証明書のなりすまし防止チェックの結果。これには、リスク評価結果とリスクタイプが含まれます:
| この結果は、改ざん検出が有効な場合 (リクエストパラメーター |