ID Verification:ID_OCR_MIN

パラメータ

タイプ

必須

説明

例

ProductCode

String

はい

使用する製品プラン。ID ドキュメント OCR API の場合は、値を ID_OCR_MIN に設定します。

ID_OCR_MIN

SceneCode

String

いいえ

コンソールで関連レコードをクエリするために使用できるカスタム認証シナリオ ID。ID は最大 10 文字で、英字、数字、アンダースコア (_) を含めることができます。

1234567890

MerchantBizId

String

はい

追跡とトラブルシューティングのための、カスタムの一意なビジネス ID。ID は、最大 32 文字の英字と数字の文字列にすることができます。この ID がリクエストごとに一意であることを確認してください。

e0c34a77f5ac40a5aa5e6ed20c35****

MerchantUserId

String

はい

電話番号やメールアドレスなどのカスタムユーザー識別子。送信前に、ハッシュ化などを使用してこの値をマスクすることを強く推奨します。

123456789

IdOcrPictureBase64

String

いいえ。3 つのアップロード方法のいずれかを選択してください。

ID ドキュメントの base64 エンコードされた画像。この方法を使用する場合は、データ転送制限を超えないように画像サイズを確認してください。

base64

IdOcrPictureUrl

String

ID ドキュメント画像の公開アクセス可能な HTTP または HTTPS URL。

https://***

IdOcrPictureFile

InputStream

ID ドキュメント画像のファイルストリーム。

統合手順については、「特別なシナリオ: Advance インターフェースによるファイルアップロード」をご参照ください。

DocType

String

はい

8 桁の一意な識別子で指定するドキュメントタイプです。詳細については、「ドキュメントタイプ」をご参照ください。

01000000

Spoof

String

いいえ

[OCR 設定] なりすまし防止機能を有効にするかどうかを指定します。

• T： なりすまし防止機能を有効にします (デフォルト)。

• F： なりすまし防止機能を無効にします。

F

IdThreshold

String

いいえ

3

CardSide

String

いいえ

[OCR 設定] 認識する ID ドキュメントの面。デフォルトは顔写真面です。

• OCR_ID_FACE： 顔写真面 (デフォルト)。

• OCR_ID_NATIONAL_EMBLEM： 国章面。

OCR_ID_NATIONAL_EMBLEM

パラメータ

タイプ

説明

例

HTTP Status Code

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.Passed

String

認証結果。有効な値：

• Y： 合格

• N： 不合格

Y

Result.SubCode

String

認証結果の説明。詳細については、「Result.SubCode エラーコード」をご参照ください。

200

Result.ExtIdInfo

String

ID ドキュメント認識結果。JSON 形式については、右側の例をご参照ください。詳細については、「ExtIdInfo」をご参照ください。

{
  "ocrIdInfo": {
    "expiryDate": "",
    "originOfIssue": "Bureau of Exit and Entry Administration of the Ministry of Public Security",
    "englishName": "LI SI",
    "sex": "Male",
    "name": "LI SI",
    "idNumber": "H11111112",
    "issueDate": "2013-01-02",
    "birthDate": "1990-02-21"
  },
  "spoofInfo": {
    "spoofResult": "Y",
    "spoofType": [
      "SCREEN_REMARK"
    ]
  }
}

エラーコード

課金対象

説明と提案

200

はい

認証に成功しました。

212

はい

ドキュメントなりすまし防止検知でリスクが検出されました。これは、画面再撮影、改ざん、コピーなどのリスクの高いアクティビティが原因である可能性があります。

213

はい

システムが指定されたドキュメントタイプを検出しなかったか (指定ドキュメント認識モード)、ドキュメントタイプを識別できませんでした (自動分類モード)。

鮮明で完全な、正しい向きのドキュメント画像を提供してください。