跳转到内容
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 格式进行存储。 使用national_format 在 UI 中显示。

按国家/地区路由 SMS 消息

在通过消息传递提供商发送短信之前，请验证电话号码并提取其国家/地区代码。 通过特定于区域的 SMS 网关路由消息，以降低成本并提高传送率。

阻止注册表单中的无效号码

验证提交注册表时的电话号码。 立即拒绝无效号码并向用户显示国家格式作为对解析内容的确认，在打字错误到达您的数据库之前捕获它们。

Frequently asked questions

接受哪些电话号码格式？
端点接受国际格式 (+14155552671)、国家格式 ((415) 555-2671) 以及最常见的破折号、点或空格的变体。 包含国家/地区代码前缀可提供最准确的结果。
我什么时候应该使用国家参数？
当电话号码不包含国家/地区代码前缀（例如，“4155552671”不带“+1”）时，请使用国家/地区参数。 国家/地区提示告诉解析器要应用哪个编号计划。
什么是 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