POST AI agent ready /v1/phone

電話認証 API - 無料の番号パーサー

電話番号を解析して検証します。フォーマットされたバージョン (E.164、各国語)、国コード、および国名を返します。

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/phone \
  -H "Content-Type: application/json" \
  -d '{"phone":"+14155552671","country":"US"}'

When to use this API

連絡先データベース内の電話番号を正規化する

ユーザーは、「415-555-2671」、「(415) 555 2671」、「+1 415.555.2671」など、数十の形式で電話番号を入力します。このエンドポイントを通じてそれぞれを解析して、保存用の標準化された E.164 形式を取得します。 UI での表示には、national_format を使用します。

SMS メッセージを国別にルーティングする

メッセージングプロバイダーを通じて SMS を送信する前に、電話番号を検証し、国コードを抽出します。地域固有の SMS ゲートウェイを介してメッセージをルーティングして、コストを削減し、配信率を向上させます。

登録フォームで無効な番号をブロックする

登録フォームの送信時に電話番号を検証します。無効な番号を直ちに拒否し、解析された内容の確認として各国の形式を表示し、データベースに到達する前にタイプミスを検出します。

Frequently asked questions

どのような電話番号形式が受け入れられますか?

エンドポイントは、国際形式 (+14155552671)、国内形式 ((415) 555-2671)、およびダッシュ、ドット、またはスペースを含む最も一般的なバリエーションを受け入れます。国コードの接頭辞を含めると、最も正確な結果が得られます。

国パラメータはどのような場合に使用する必要がありますか?

電話番号に国コードのプレフィックスが含まれていない場合 (例: "+1" のない "4155552671") は、country パラメータを使用します。国のヒントは、どの番号付け計画を適用するかをパーサーに指示します。

E.164形式とは何ですか?

E.164 は電話番号の国際標準です。「+」で始まり、その後に国番号と加入者番号が続きます。スペースや句読点は含まれません。例: +14155552671。

これにより、電話番号が使用中であることが確認されますか?

いいえ。このエンドポイントは形式と構造のみを検証します。番号がアクティブであることを確認するために、その番号に電話をかけたりテキストメッセージを送信したりすることはありません。

固定電話番号と携帯電話番号を検証できますか?

はい。パーサーは、固定電話と携帯電話の両方の番号形式を処理します。国の番号計画規則に基づいて検証されます。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.