はじめに
連携 / SDK
ユーザー認証
法人確認
トランザクションモニタリング
変更履歴エンドポイント
電話番号コードの送信
POST /v3/phone/send/：SMSでワンタイム認証コードを送信します。電話番号コードの確認
POST /v3/phone/check/：コードを検証し、電話番号のリスクデータを取得します。電話番号リスクのスコアリング
POST /v3/phone/risk/：OTPを送信せずに、キャリア、回線種別、番号ポータビリティ、不正リスクをスコアリングします。仕組み
- E.164形式の電話番号(例:
+14155552671)を指定してSend Phone Codeを呼び出します - ユーザーがSMSでコードを受け取ります(有効期間は5分間)
- 電話番号とコードを指定してCheck Phone Codeを呼び出します
- 検証結果とリスクシグナル(キャリア種別、仮想番号の検出)を受け取ります
配信チャネル
Diditは、国ごとの提供状況に応じて複数のチャネルに対応しています。リスクシグナル
レスポンスの全体構造については、電話番号検証レポートを参照してください。
プロバイダー障害
上流の電話サービスプロバイダーが送信または確認のリクエストに応答しない場合、どちらのエンドポイントも汎用エラーではなく、code: "phone_provider_unavailable"を含む502を返します。このエラーは安全に再試行でき、課金されず、番号ごとの1時間あたりの試行上限も消費しません。メッセージの文言は安定した仕様ではないため、detailメッセージを解析するのではなく、codeで分岐してください。