コンテンツへスキップ
POST AI agent ready /v1/phone

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

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

Parameters

stringrequired

Phone number to validate. Include the country code for best results.

string

ISO 3166-1 alpha-2 country code hint for parsing numbers without a country prefix.

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.

Sign up free View full docs