Phone Number Validation API

Quickly validate phone numbers from 240+ countries, detect carrier, country, region, timezone, and get E.164/national/international formats, built on the same library used by Google, WhatsApp, Twilio, and Stripe.

原始信息汇总

Phone Number Validation API 数据集概述

基本信息

• 数据集名称：Phone Number Validation API
• 类别：Communication
• 提供者：API Phase Studio
• 订阅者数量：2

定价计划

• BASIC：$0.00 / 月
• PRO：$3.99 / 月
• ULTRA：$13.99 / 月
• MEGA：$44.99 / 月

核心功能

• 验证号码置信度：立即判断号码在其国家/地区是否结构有效，而不仅仅是看起来像电话号码。在录入点捕获虚假、格式错误和不可能的号码，防止其污染数据库或导致递送失败。
• 获取完整号码详情：检索号码的完整细分：标准化格式（E.164、国际、国内、RFC 3966）、国家/地区电话代码、区域、运营商信息查询、地理位置和 IANA 时区。收集正确显示、存储或路由号码所需的所有数据。
• 跨来源比较号码：确定两个号码是否相同，无论其输入或格式如何。重复数据删除 CRM 记录、协调来自不同数据源的号码，并通过详细的匹配分类检测跨国家/地区代码表示的重复项。
• 分类线路类型：区分移动号码与固定电话、免费电话号码、VoIP 线路、优质费率服务、寻呼机等。根据实际号码类型，以不同方式路由呼叫、应用正确的消息传递渠道或标记无法接收短信的号码。
• 快速检查可能性：当需要快速预过滤而无需完全验证开销时，运行轻量级的长度和前缀检查。非常适合用户在输入时提供实时表单反馈。
• 生成有效示例号码：按需为任何国家/地区和线路类型生成经过验证、格式正确的示例号码。非常适合填充暂存环境、填充测试数据库以及构建可靠的端到端测试套件。

端点列表

端点	用途
GET /validate	快速电话号码验证
GET /details	完整丰富信息：运营商、类型、位置、时区、格式
GET /compare	比较两个电话号码的详细信息
GET /type	将号码分类为移动电话、固定电话、免费电话等
GET /possible	确认电话号码格式是否可能适用于该国家/地区
GET /example	为任何国家/地区生成有效的示例号码
GET /api/health	服务健康检查

覆盖范围

支持 240 多个国家和地区以及所有 ISO 3166-1 alpha-2 地区代码 的验证。编号计划数据始终保持最新，与 ITU-T 建议同步并监控国家/地区变更。

适用对象

• 产品和工程团队：需要准确的电话数据，而无需自行维护复杂的编号库。
• Web 和移动应用程序开发人员：希望实时验证用户输入，并减少因有效号码上出现混淆的错误消息而导致表单放弃。
• 数据团队：清理和重复数据删除 CRM、营销平台和数据仓库中的联系人记录。
• 欺诈和合规团队：需要在用户注册前对号码类型进行分类、验证地理来源并标记可疑模式。
• DevOps 和 QA 工程师：将电话号码验证作为 CI/CD 管道的一部分运行——动态生成有效的测试夹具，根据现实世界的编号规则验证夹具，并在问题进入生产环境之前捕获回归。
• 平台集成商：连接以不同格式存储电话号码的系统——无需编写自定义解析逻辑即可对其进行规范化、比较和协调。

技术特性

• 格式感知解析：支持所有格式。
• 线路类型分类：支持 11 种类型。
• 运营商和地理数据：包含。
• 时区解析：包含 IANA 时区。
• 号码比较：包含匹配级别。
• 示例号码生成：支持任何地区和类型。
• 所有标准格式：支持 E.164、国际、国内、RFC 3966。

HTTP 状态码

代码	含义
200	请求已处理。无效号码仍返回 200，并附带 is_valid: false。
422	格式错误的请求：缺少 number 参数，或参数过短/过长。
429	超出当前计划的速率限制。
500	内部服务器错误：请通过讨论选项卡向我们报告，我们将随时提供帮助。

常见问题解答

• 没有国家/地区代码前缀是否有效？ 是的，传递 region_code（例如 region_code=US），API 将在该国家/地区的编号计划中解释该号码，而无需 + 前缀。
• 号码字段接受什么格式？ 大多数常见格式都有效：[phone]、[phone]、415-555-2671、4155552671。始终将 + 进行 URL 编码为 %2B，或改用 region_code 参数。
• 运营商数据是否始终可用？ 不是。运营商数据适用于大多数主要市场的移动号码。对于固定线路号码和某些地区，它返回 null。
• 为什么有效号码仍无法成功发送短信？ 结构验证确认号码格式正确，但不验证号码当前是否处于活动状态或已分配给用户。
• is_valid 和 is_possible（在验证端点中）之间有什么区别？ is_valid 表示该号码符合其地区的所有格式规则。is_possible 表示该号码具有可能存在的正确长度，这是一种较弱的检查，适用于宽松的验证。