申請プロセス
API を使用するには、まず 身分証人像写真検証 API の該当ページでサービスを申請する必要があります。ページに入ったら、「Acquire」ボタンをクリックします。以下の図のように：
まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。ログインまたは登録後、現在のページに自動的に戻ります。
初回申請時には無料の利用枠が付与され、この API を無料で使用できます。
基本使用
まず、基本的な使用方法を理解します。身分証画像のリンクを入力するだけで、処理後の検証結果を得ることができます。最初にimage_url フィールドを簡単に渡す必要があります。次に、画面上に対応する内容を記入できます。以下の図のように：
accept：受け取りたいレスポンス結果の形式。ここではapplication/json、つまり JSON 形式を記入します。authorization：API を呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
image_url：処理する身分証画像のリンク。config：オプションの設定項目、ブール値フィールドで、デフォルトはすべて false です。copy_warn、border_check_warn、reshoot_warn、detect_ps_warn、temp_id_warn、quality（閾値 0-100）をサポートします。
sim、類似度、値の範囲は [0.00, 100.00] です。類似度が70以上であれば同一人物と判断できます。具体的なシーンに応じて閾値を調整できます（閾値70の誤通過率は千分の一、閾値80の誤通過率は万分の一）。result、業務エラーコード、成功の場合は Success を返し、エラーの場合は下記のエラーコードリストの FailedOperation 部分を参照してください。description、ここでは名前と身分証番号の検証結果です。name、身分証に含まれる名前情報。身分証画像がアップロードされていない場合は空です。sex、身分証に含まれる性別情報。身分証画像がアップロードされていない場合は空です。nation、身分証に含まれる民族情報。身分証画像がアップロードされていない場合は空です。birth、身分証に含まれる誕生日情報。身分証画像がアップロードされていない場合は空です。address、身分証に含まれる家庭住所情報。身分証画像がアップロードされていない場合は空です。id_num、身分証に含まれる身分証番号情報。身分証画像がアップロードされていない場合は空です。portrait、身分証の顔写真の base64 コード。切り抜きに失敗した場合は、全体の身分証で照合し、空を返します。warnings、警告情報。Config で警告情報が設定されている場合、人像照合が停止し、Result がエラー（FailedOperation.OcrWarningOccurred）を返し、この警告情報が表示されます。quality、画像の品質スコア。リクエスト Config で画像のぼやけ警告が設定されている場合、このパラメータは意味を持ちます。値の範囲は（0～100）で、現在のデフォルト閾値は50点で、50点未満はぼやけ警告を引き起こします。encryption、機密データの暗号情報。
エラー処理
API を呼び出す際にエラーが発生した場合、API は対応するエラーコードと情報を返します。例えば：400 token_mismatched：不正なリクエスト、パラメータが欠落または無効である可能性があります。400 api_not_implemented：不正なリクエスト、パラメータが欠落または無効である可能性があります。401 invalid_token：未承認、無効または欠落した承認トークン。429 too_many_requests：リクエストが多すぎます、レート制限を超えました。500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。