このトピックでは、CheckResult API 操作を呼び出して認証結果をクエリする方法について説明します。
API の説明
API 操作名: CheckResult
リクエストメソッド: HTTPS POST
説明: コールバック通知を受信した後、サーバーサイドでこの API 操作を呼び出して、認証ステータスと資料を取得できます。
重要デフォルトでは、ID Verification サービスの結果は 30 日間保存された後、自動的に削除されます。 30 日以内に検証結果を取得する必要があります。
この API 操作には専用の QPS 制限があります。 詳細については、「ID Verification サーバーサイド API 操作の QPS 制限」をご参照ください。
エンドポイント:
説明内部ネットワークアクセスの利点: 内部ネットワークは、同一リージョン内の Alibaba Cloud プロダクト間のプライベート通信ネットワークです。 ご利用のビジネスサーバーが対応する Alibaba Cloud リージョンにデプロイされている場合、内部の同一リージョンエンドポイントを使用して ID Verification サービスにアクセスできます。 これにより、より安全で安定した通信が提供されます。
中国以外からのアクセスの最適化に関する提案: 中国以外のネットワーク環境は複雑になる可能性があります。 統合ソリューションを最適化し、ネットワーク遅延を削減し、リクエストの失敗を最小限に抑えるには、「サーバーサイドのネットワーク遅延分析と最適化」をご参照ください。
中国 (香港)
パブリックネットワーク:
cloudauth-intl.cn-hongkong.aliyuncs.com内部ネットワーク:
cloudauth-intl-vpc.cn-hongkong.aliyuncs.com
オンラインでのデバッグと統合
API 操作をデバッグおよび統合する前に、「OpenAPI Explorer を使用したサーバーサイド API 操作のデバッグと統合」で API 操作の呼び出し方法、SDK とサンプルコードの取得方法をご確認ください。
この API 操作は OpenAPI Explorer で実行してデバッグし、SDK コードサンプルを生成できます。
リクエストパラメーター
名前 | タイプ | 必須 | 説明 | 例 |
MerchantBizId | String | はい | カスタマイズする一意のビジネス識別子。 問題の追跡とトラブルシューティングに使用します。 識別子は、文字と数字で構成される一意の 32 文字の文字列である必要があります。 説明 Alibaba Cloud サーバーはこのフィールドの一意性をチェックしません。 追跡を改善するために、このフィールドが一意であることを確認してください。 | e0c34a77f5ac40a5aa5e6ed20c35**** |
TransactionId | String | はい | 検証フロー全体の一意の識別子。 Initialize API 操作を呼び出してこの値を取得します。 重要 改ざんを防ぐため、Initialize 操作を呼び出す際には、クライアントサイドのコールバックから返された TransactionId ではなく、サーバーに保存されている TransactionId を使用してください。 | hksb7ba1b28130d24e015d6******** |
IsReturnImage | String | いいえ | 認証イメージ資料を返すかどうかを指定します:
| Y |
レスポンスデータ
名前 | タイプ | 説明 | 例 | |
HTTP ステータスコード | Integer | HTTP ステータスコード。 | 200 | |
HTTP ボディ | RequestId | String | リクエスト ID。 | 130A2C10-B9EE-4D84-88E3-5384FF03**** |
Code | String | Success | ||
Message | String | 応答コードの詳細な説明。 | success | |
Result.Passed | String | 最終的な認証結果。 有効値:
| Y | |
Result.SubCode | String | 認証結果の説明。 詳細については、 「ResultObject.SubCode のエラーコード」をご参照ください。 | 200 | |
Result.ExtFaceInfo | String | 顔のライブネス検証の結果。 JSON フォーマットについては、右側の例をご参照ください。 詳細については、「ExtFaceInfo」をご参照ください。 | | |
ExtFaceInfo
名前 | タイプ | 説明 | 例 |
facePassed | String | 顔のライブネス検証の最終結果。
| Y |
faceImg | String | キャプチャされた顔イメージの Base64 フォーマット。 このフィールドは、リクエストで | Base64 フォーマット |
faceAttack | String | キャプチャされた顔でライブネス攻撃が検出されたかどうかを示します。 Y: 攻撃が検出されました。 N: 攻撃は検出されませんでした。 | N |
faceQuality | Double | 顔のライブネス検証のための顔イメージの品質スコア。 値の範囲は 0 から 100 です。 | 99.99 |
faceOcclusion | String | 顔が遮蔽されているかどうかを示します。 Y: 顔は遮蔽されています。 N: 顔は遮蔽されていません。 | N |
docVideoUrl | String | 証拠ビデオの OSS ダウンロード URL。 説明
| https://aliyun-cloudauth.oss-aliyuncs.com/******.webm |
faceAge | String | 顔イメージに基づいて予測された参考年齢。 予測に失敗した場合、このフィールドは返されないことがあります。 | 30 |
faceGender | String | 顔イメージに基づいて予測された性別。 予測に失敗した場合、このフィールドは返されないことがあります。
| M |
authorityComparisonScore | Double | キャプチャされた顔と公式の権威あるデータソースからの顔との顔照合の類似度スコア。 値の範囲は 0 から 100 です。 説明 スコアが高いほど、顔が同一人物のものである確率が高くなります。 デフォルトのしきい値は 75 です。 ビジネスデータに基づいてしきい値をカスタマイズすることもできます。 | 99.99 |
faceAttackScore | Double | 顔認識アルゴリズムによって予測されたなりすまし攻撃の確率。 スコアが高いほど、なりすまし攻撃の確率が高くなります。 値の範囲は 0 から 100 です。 | 80 |
guardRiskScore | Double | Face-Guard アルゴリズムによって予測されたデバイスリスクの確率。 スコアが高いほど、デバイスリスクが高くなります。 値の範囲は 0 から 100 です。 | 90 |
リターンコード
HTTP ステータスコード | コード | メッセージの説明 |
200 | Success | リクエストは成功しました。 |
400 | MissingParameter | パラメーターを空にすることはできません。 |
InvalidParameter | 無効なパラメーターです。 | |
TransactionIdInvalid | 無効なトランザクション ID です。 | |
403 | Forbidden.RAMUserAccessDenied | RAM ユーザーに AliyunAntCloudAuthFullAccess 権限を付与する必要があります。 詳細については、「RAM ユーザーにサービスへのアクセスを許可する」をご参照ください。 |
Forbidden.AccountAccessDenied | ID Verification を有効にし、アカウントに支払い遅延がないことを確認してください。 | |
Throttling.Api | スロットリングにより API リクエストがブロックされました。 | |
404 | ProcessNotCompleted | 認証プロセス全体が完了していません。 |
500 | InternalError | 内部システムエラー。 トラブルシューティングのためにエンジニアにフィードバックを提供してください。 |
503 | ServiceUnavailable | サービスは利用できません。 トラブルシューティングのためにエンジニアにお問い合わせください。 |
ResultObject.SubCode のエラーコード
エラーコード | 認証レコードは課金対象ですか? | 説明、原因、および推奨事項 |
200 | はい | 認証が成功しました。 |
201 | はい | 名前と ID カード番号が公式データベースの情報と一致しません。 ユーザー情報が正しくないか、偽物である可能性があります。 ユーザーに情報を確認して再試行するようアドバイスしてください。 説明 このエラーコードは、プロダクトによって検証される証明書のタイプが中国の ID カードであり、権威検証機能が有効になっている場合にのみ返されます。 |
202 | はい | 公式データベースで ID 情報が見つかりません。 手動レビューのエントリを予約してください。 説明 このエラーコードは、プロダクトによって検証される証明書のタイプが中国の ID カードであり、権威検証機能が有効になっている場合にのみ返されます。 |
205 | はい | ライブネス検知にはリスクが伴います。 |
206 | はい | ビジネスポリシーによって制限されています。 セーフモードを有効にすると、システムはデバイスなどの認証環境に対してセキュリティチェックを実行します。 潜在的な脅威が検出されると、認証は失敗します。 次のように問題をトラブルシューティングできます:
|
207 | はい | 公式データベースに対する顔認識が失敗しました。 人物が同一でないか、ライブ写真の品質が低い可能性があります。 説明 このエラーコードは、プロダクトによって検証される証明書のタイプが中国の ID カードであり、権威検証機能が有効になっている場合にのみ返されます。 |