{
"tool": "phone-validator",
"count": 1,
"results": [
{
"input": "(312) 555-0101",
"valid": true,
"possible": true,
"e164": "+13125550101",
"national": "(312) 555-0101",
"international": "+1 312 555 0101",
"rfc3966": "tel:+13125550101",
"country": "US",
"countryCallingCode": "+1",
"type": "FIXED_LINE_OR_MOBILE",
"extension": null,
"error": null
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14718/phone+number+validator+and+formatter+api/38077/phone+number+validation?items=(312) 555-0101&defaultCountry=US&dedupe=true' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 电话号码验证器和格式化器 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
验证和格式化全球的电话号码。返回每个号码的有效性、E.164格式、国家、号码类型和国家格式。
发送最多25个以逗号分隔的值的items查询参数 可选参数:defaultCountry,dedupe
包含工具、计数和结果数组的JSON。每个结果行具有与本页示例响应相同的字段
一个电话算作一个请求,即使它同时请求多达25部电话。在同一个电话中请求更多选项或更高的限制仍然算作一个请求
大多数调用在2到15秒内返回 超过80秒后会得到HTTP 503并带有Retry-After; 发送更少的项目并重试
可选查询参数:defaultCountry,dedupe。每个参数在本页面的参数下列出,并附有其允许的值或范围。超出这些限制的值将返回HTTP 400及允许范围。
JSON 错误信息:缺失或无效参数时为 400(包括允许的值),请求无法处理时为 422,超过速率限制时为 429,当繁忙或超过 80 秒时为 503 并带有 Retry-After。带有错误字段的行是该项的正常 200 结果(例如,一个无效或无法识别的号码,返回的有效性为 false)
该端点返回有关电话号码有效性的数据,包括其E.164格式、国家格式、国家、类型,以及它们是否有效或可能。每个条目为提交的每个电话号码提供详细信息
响应中的关键字段包括“输入”(原始号码) “有效”(真/假) “e164”(E.164格式) “国家”(国家格式) “国际”(国际拨号格式) “国家”(ISO国家代码) 和“类型”(号码分类)
响应的结构为一个 JSON 对象,包含一个 "tool" 标识符,一个已处理项目的 "count" 以及一个 "results" 数组。每个结果对应一个输入数字,并包括详细的验证和格式信息
该端点提供有关电话号码有效性、格式(E.164 和国家)、来源国、号码类型(例如,移动或固定电话)以及与输入号码相关的潜在错误的信息
用户可以通过使用 "defaultCountry" 参数来设置验证的国家,并使用 "dedupe" 参数从结果中删除重复条目,从而定制请求。这允许根据特定需求进行量身定制的验证
"valid"表示号码是否有效 "e164"提供标准的国际格式 "national"显示本地拨号格式 "country"指定国家代码 "type"对号码进行分类(例如,手机 固定电话)
典型的使用案例包括验证用户提交的电话号码、为国际拨号格式化号码、确保遵守当地法规,以及增强客户沟通策略
数据准确性通过来自可靠电信来源的定期更新和验证算法得以维持,这些算法检查数字格式和分类是否符合既定标准