查询路由信息

请求获取北美电话号码的路由信息。请用它来解读可用的路由或运营商数据，不要将其作为用户身份、号码归属权、能否接通或是否可购买的证明。查询可能会向您的账户收取费用。

请求

使用您已启用的 API 账户及其允许的来源 IP 地址。请以纯数字形式提供完整号码，包括国家代码 1。示例使用环境变量和虚构号码。处理程序不会对标点符号进行规范化处理；请在提交前验证输入。

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

响应

仅展示部分字段作为示例；字段是否可用取决于数据来源和号码类型。

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "lrn": "12025550123",
    "ocn": "0000",
    "local": 1,
    "ported": 0,
    "cost": "$0.00025"
  }
}

标准查询会将返回的字段名转换为小写。根据数据来源，响应中可能包含运营商、资费中心、位置和管辖区域字段。响应并非格式固定且完整的用户记录。local 标志可能是数值 1，也可能是字符串 0。处理程序通过比较返回的路由号码与所提供的电话号码来计算 ported；不要将其理解为经过核实的完整携号转网历史。

价格与重试

经审查的处理程序执行到完成路径并记录查询时，会从账户扣除 $0.00025。返回的费用通常是包含美元符号的字符串，而非单纯的数值金额。系统未提供幂等键。重复请求可能会再次产生费用。

对于预付费账户，代码会检查余额是否至少为 0.00025。目前，余额不足消息中提到的金额是 $5，与该阈值不一致。请将此失败理解为因余额问题而被拒绝，并在重试前确认账户资金。

失败与不完整的成功结果

请同时查看 HTTP 状态和 JSON 中的 status.code/status.msg。标准查询结果为空时，会返回 API 代码 404。API 代码 403 可能表示预付费余额不足。

当前针对免费电话号码的一条错误处理路径，即使没有提供有用的路由字段，仍可能扣除查询费用并报告 API 代码 200；其费用信息可能不完整。因此，仅凭 200 代码不能认定查询结果可用。请验证应用所需的字段，将不确定的费用与账户账单记录核对，并就不完整的结果联系支持团队。

在经审查的实现中，输入长度不同，免费电话号码的处理方式也不同。请优先使用完整的国际号码数字，并向支持团队确认所需的免费电话号码覆盖范围。对于格式错误或不完整的结果，不要自动重试，也不要依赖路由查询来判定拨打某个号码是否安全或是否已获授权。