检查北美号码分配覆盖范围

检查分配表覆盖范围

检查北美号码是否与 MultiTEL 分配表中的某个前缀匹配，并获取对应的城市、州和国家信息。这是一项前缀表查询。它不能证明用户处于活跃状态、号码已分配、号码属于您的账户，或您可以订购该号码。

请求

请使用已启用的 API 账户和获准的来源 IP 地址。示例使用环境变量中的 HTTP Basic 身份验证凭据和一个虚构号码。无需请求体。

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/nanpacheck/12025550123

建议使用以 1 开头的十一位北美号码。处理程序会移除非数字字符，并在十位数字输入的前面加上 1。其他位数的输入会被拒绝。这种规范化处理并不验证所有北美号码编排规则，因此成功匹配分配表并不代表已对号码进行全面验证。

响应

字段值仅作示例；这不是实际分配表的查询结果。

{
  "status": {
    "code": 200,
    "msg": "12025550123"
  },
  "response": {
    "number": "12025550123",
    "npanxx": "1202555",
    "city": "Example City",
    "state": "DC",
    "country": "US"
  }
}

分配匹配字段
字段	含义
number	经过规范化处理、仅包含数字的输入。
npanxx	匹配到的已存储前缀。处理程序优先匹配包含国家代码、区号和交换局代码的七位前缀，也可回退到包含国家代码和区号的四位前缀；请勿假定此字段始终标识完整的交换局代码。
city, state, country	匹配到的分配前缀的元数据。这些字段不能确定用户当前的实际地理位置，也不能确定号码携号转网后的当前运营商。

错误

请读取 JSON 中的 status.code，不要仅依赖 HTTP 200。API 状态码 404 及消息 Not part of NANPA 表示在该服务使用的表中未匹配到任何前缀；这并非对全球号码管理机构归属的最终判定。数字位数无效或未提供号码时，会使用 API 状态码 500。

费用与后续操作

经审核的处理程序执行本地分配表查询，不包含账户扣费或外部查询操作。此处理程序不收取查询费用。请使用可用号码搜索查找可订购的库存号码。名称查询、路由查询或号码订购均属于其他操作，分别按账户对应的价格计费。