开发者

GET/v3/lnp/project/{uniqueid}/numbers

列出携转项目中的号码

读取每个号码保存的状态、备注和计划转移信息。

本页
  1. 账户和项目访问权限
  2. 请求
  3. 响应
  4. 号码字段
  5. 排序和监控
  6. 理解携转状态
  7. 错误和限制
  8. 影响

账户和项目访问权限

从获准的IP地址使用已启用的API账户,通过HTTPS访问。项目必须属于该账户且未被删除。请使用携转订单流程中的项目唯一ID,而不是数据库中的数字ID或电话号码。构建请求时,请对项目ID进行URL编码。

请求

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/lnp/project/$PROJECT_ID/numbers"

响应

虚构的响应示例。

{
  "status": {
    "code": 200,
    "msg": "Project Numbers",
    "results": 1
  },
  "response": [
    {
      "id": 21,
      "number": "12025550123",
      "status": 0,
      "status_str": "Pending",
      "isocode": "US",
      "updated": "2026-10-23 12:00:00",
      "foc": "",
      "comment": "Example customer-visible note",
      "date_created": "2026-10-23 12:00:00",
      "date_completed": ""
    }
  ]
}

response是一个列表。现有项目没有号码时,返回空列表,API代码为200,status.results为0。不存在的项目则返回API代码404。

号码字段

携转号码字段
字段含义
id, number, isocode数字行ID、保存的电话号码文本和国家代码。行ID不是项目ID。
status, status_str数字状态及其已知标签。
foc保存的最终订单承诺排期值。此值可能为空;处理程序不会将其转换为已文档化的时区或时间戳格式。
updated, date_created, date_completed保存的更新时间、创建时间和完成时间值。请明确处理空值;不要假定其采用ISO8601格式,也不要根据虚构示例推断时区。
comment保存的面向客户的备注。请将其作为文本显示,而不是可执行的HTML。

此返回结构不包含仅供员工使用的internal_comment字段。这并不意味着单独的旧版单号码查询也采用相同的返回结构。

排序和监控

查询按创建时间升序排列。创建时间相同的行不保证其他排序。没有分页、增量游标或日期筛选器。请读取完整列表以核对项目,不要把当前行数当作固定的目录。

理解携转状态

已知的号码状态值
值标签
0Pending
1In Progress
2Completed
9Rejected

请保留数字状态并兼容未知值。遇到未知标签时,将回退到保存的值,而不保证提供新标签。保存的完成状态或计划日期本身并不构成对入站路由或该号码所有服务的测试。

错误和限制

请同时检查HTTP响应和status.code/status.msg。项目不存在、已删除或不属于该账户时,会返回API代码404及项目未找到消息。身份验证和来源IP限制同样适用。示例不会发出实时请求,成功响应也不能证明运营商已接受或完成转移。

影响

已审阅的处理程序只读取项目及其保存的号码行。响应是一个快照,不是运营商确认,也不是实时服务测试。它不会发起携转、改变路由或扣除账户余额。