このトピックでは、2 要素 ID Verification の API 操作について説明します。
2 要素 ID Verification
API 操作: Id2MetaVerifyIntl
リクエストメソッド: POST および GET
プロトコル: HTTPS
説明: 名前と ID カード番号が一致するかどうかを検証します。
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
オンラインでのデバッグと統合
デバッグと統合を開始する前に、「OpenAPI を使用したサーバーサイド API のデバッグと統合」ドキュメントを確認して、OpenAPI プラットフォームで API 操作を呼び出し、SDK とサンプルコードを取得する方法を学習してください。
この API 操作は OpenAPI Explorer で実行してテストを行い、SDK コードサンプルを生成できます。
リクエストパラメーター
名前 | タイプ | 必須 | 説明 | 例 |
ProductCode | String | はい | プロダクトプラン。これは静的フィールドです。値を ID_2META に設定します。 | ID_2META |
ParamType | String | はい | パラメーターのタイプ。 normal: プレーンテキストの元の値。 説明 信頼できるデータソースの制限により、2 要素 ID Verification は MD5 暗号化をサポートしていません。 | normal |
IdentifyNum | String | はい | ID カード番号。 説明 中国本土の居住者の ID カードのみがサポートされています。 | 411***********0001 |
UserName | String | はい | 名前。 | Zhang* |
レスポンスパラメーター
名前 | タイプ | 説明 | 例 | |
RequestId | String | リクエスト ID。 | 130A2C10-B9EE-4D84-88E3-5384FF039795 | |
Code | String | Success | ||
Message | String | レスポンスコードの詳細な説明。 | success | |
Result | Object | なし。 | なし | |
| BizCode | String | 検証結果:
| 1 |
リターンコード
HTTP ステータスコード | コード | 説明 |
200 | Success | リクエストは成功しました。 |
400 | MissingParameter | パラメーターを空にすることはできません。 |
Forbidden.ExceptionRepeatedInvoke | 繰り返される異常な呼び出しの数が制限を超えています。 | |
401 | InvalidParameter | 無効なパラメーター。 |
403 | Forbidden.AccountAccessDenied | ID Verification をアクティブ化し、アカウントに支払い遅延がないことを確認してください。 |
Forbidden.RAMUserAccessDenied | Resource Access Management (RAM) ユーザーに AliyunAntCloudAuthFullAccess 権限を付与します。 | |
500 | Forbidden.ExceptionDataSource | 信頼できるデータソースサービスが異常です。 |
InternalError | 内部システムエラーが発生しました。トラブルシューティングについては、当社のエンジニアにお問い合わせください。 |