> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 電話番号認証API：SMS OTPとリスクシグナル

> DiditのAPIでSMS OTPによる2ステップの電話番号認証を実施し、キャリア、仮想番号、使い捨て番号を検出します。従量課金制で、キャリア料金に$0.02の手数料のみ。契約は不要です。

電話番号検証APIは2ステップのフローを提供します。まず電話番号にワンタイムコードを送信し、次にそのコードを検証します。システムはキャリアの種別、仮想番号、使い捨て電話番号を検出します。

## エンドポイント

> [card] [電話番号コードの送信](https://docs.didit.me/ja/standalone-apis/phone-send.md)
>
> `POST /v3/phone/send/`：SMSでワンタイム認証コードを送信します。

> [card] [電話番号コードの確認](https://docs.didit.me/ja/standalone-apis/phone-check.md)
>
> `POST /v3/phone/check/`：コードを検証し、電話番号のリスクデータを取得します。

> [card] [電話番号リスクのスコアリング](https://docs.didit.me/ja/standalone-apis/phone-risk.md)
>
> `POST /v3/phone/risk/`：OTPを送信せずに、キャリア、回線種別、番号ポータビリティ、不正リスクをスコアリングします。

## 仕組み

1. E.164形式の電話番号(例: `+14155552671`)を指定して**Send Phone Code**を呼び出します
2. ユーザーがSMSでコードを受け取ります(有効期間は5分間)
3. 電話番号とコードを指定して**Check Phone Code**を呼び出します
4. 検証結果とリスクシグナル(キャリア種別、仮想番号の検出)を受け取ります

## 配信チャネル

Diditは、国ごとの提供状況に応じて複数のチャネルに対応しています。

| チャネル | 説明 |
| - | - |
| SMS | 標準のテキストメッセージ |
| WhatsApp | WhatsAppメッセージ |
| Telegram | Telegramメッセージ |
| RCS | Rich Communication Services |
| Viber | Viberメッセージ |

## リスクシグナル

| シグナル | 説明 |
| - | - |
| `is_disposable` | 一時的または使い捨ての電話番号 |
| `is_virtual` | VoIPまたは仮想番号 |
| `carrier.type` | `mobile`、`landline`、または`voip` |

レスポンスの全体構造については、[電話番号検証レポート](https://docs.didit.me/ja/core-technology/phone-verification/overview.md)を参照してください。

## プロバイダー障害

上流の電話サービスプロバイダーが送信または確認のリクエストに応答しない場合、どちらのエンドポイントも汎用エラーではなく、`code: "phone_provider_unavailable"`を含む`502`を返します。このエラーは安全に再試行でき、課金されず、番号ごとの1時間あたりの試行上限も消費しません。メッセージの文言は安定した仕様ではないため、`detail`メッセージを解析するのではなく、`code`で分岐してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.