申請プロセス
身分証人像写真検証 API を使用するには、まず Ace Data Cloud コントロールパネル にアクセスして、API トークンを取得し、保管してください。
まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。
1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コントロールパネル で一般残高をチャージできます。
📘 完全なドキュメント：身分証人像写真検証 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：内部サーバーエラー、サーバーで何かがうまくいきませんでした。