Skip to main content
本文では、携帯番号三要素確認 API 接続説明を紹介します。これは、携帯番号、氏名、及び身分証明書番号の真実性と一貫性を確認するために使用できます。

​
申請プロセス

携帯番号三要素確認 API を使用するには、まず Ace Data Cloud コンソール にアクセスして、API トークンを取得し、保管してください。 まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。 1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソール で共通残高をチャージできます。
📘 完全なドキュメント：携帯番号三要素確認 API →

​
基本使用

まず基本的な使用方法を理解します。携帯番号を入力することで、処理された結果を得ることができます。最初に phone フィールドを簡単に渡す必要があります。次に、画面上に対応する内容を入力できます。以下の図のように：

ここでは、リクエストヘッダーを設定しました。これには以下が含まれます：
  • accept：受け取りたいレスポンス結果の形式。ここでは application/json、つまり JSON 形式を記入します。
  • authorization：API を呼び出すためのキー。申請後、直接ドロップダウンから選択できます。
さらに、リクエストボディを設定しました。これには以下が含まれます：
  • name：処理するユーザーの氏名。必須パラメータです。
  • phone：処理する携帯番号。必須パラメータです。
  • id_card：処理するユーザーの身分証明書番号。必須パラメータです。
  • verify_mode：確認モード（長版/短版）。
  • encrypt_list/ciphertext_blob/iv：必要に応じて機密フィールドを暗号化するためのオプションの暗号化パラメータ。
選択後、右側にも対応するコードが生成されていることがわかります。以下の図のように：

「Try」ボタンをクリックするとテストが行えます。上の図のように、以下の結果が得られました：
返された結果には複数のフィールドがあり、以下のように説明されます：
  • result、認証結果コード。料金状況は以下の通りです。
    • 料金結果コード：
      • 0: 検証結果一致
      • 1: 検証結果不一致
    • 無料結果コード：
      • -1: 記録なし
      • -2: エンジン未知のエラー
      • -3: エンジンサービス異常
      • -4: 氏名確認不通過
      • -5: 携帯番号不合法
      • -6: 認証回数が当日の制限を超えました。翌日再試行してください。
  • description、業務結果の説明。
携帯番号、氏名、及び身分証明書番号の真実性と一貫性の情報がすでに照会されていることがわかります。 また、対応する接続コードを生成したい場合は、生成されたものを直接コピーできます。例えば、CURL のコードは以下の通りです：
Python の接続コードは以下の通りです：

​
エラー処理

API を呼び出す際にエラーが発生した場合、API は対応するエラーコードと情報を返します。例えば：
  • 400 token_mismatched：不正なリクエスト、パラメータが不足または無効である可能性があります。
  • 400 api_not_implemented：不正なリクエスト、パラメータが不足または無効である可能性があります。
  • 401 invalid_token：未承認、無効または不足している認証トークン。
  • 429 too_many_requests：リクエストが多すぎます、レート制限を超えました。
  • 500 api_error：内部サーバーエラー、サーバーで何かがうまくいきませんでした。

​
エラー応答の例

​
結論

この文書を通じて、携帯番号三要素確認 API を使用して携帯番号、氏名、及び身分証明書番号の真実性と一貫性を確認する方法を理解しました。この文書が、API の接続と使用をより良くする手助けとなることを願っています。何か問題があれば、いつでも技術サポートチームにお問い合わせください。