检查交换机的移动库存

选择受支持的前缀

请使用发现结果中的当前单个移动前缀。此端点适用于 NANPA 交换机：NPA 标识区号，NXX 标识交换机。仅区号的前缀范围过宽。请勿发送分组显示 ID，也不要因为某国家的前缀包含足够数字而推断其受支持。

将计数用作提示

读取 response.count，其中 response.npa 和 response.nxx 标识交换机。这是覆盖服务的快照，而非为您的账户保留的库存。下单前请确认实际号码、适用的报价以及任何注册要求。成功的计数绝不构成购买授权。

区分零库存与查询失败

成功的零计数与 API 错误不同。请检查 status.code 和 status.msg 以及 HTTP 状态。将超时或查询失败视为可用性未知，稍后通过退避策略重试。

请求

通过 HTTPS 使用您已启用的 API 账户凭据。支持 Basic 身份验证和已启用的 API 账户持有者令牌；账户限制适用。

使用 GET，前缀标识符位于 URL 路径中。没有记载的查询或正文参数。

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobilecount/$PREFIX_ID"

路径参数
名称	类型	必填	描述
`prefix_id`	string	是	从发现响应中复制单个前缀 ID。使用包含区号 (NPA) 和交换机 (NXX) 的受支持 NANPA 移动前缀，而非仅区号或分组摘要 ID。请将该标识符视为不透明的。

响应

检查 JSON 正文中的 status.code 以及 HTTP 状态。成功的 response 具有 status.code 200 和 status.msg Results。response 是一个对象而非列表：count 是整数库存快照；npa 和 nxx 是三字符字符串。status.results 在此关联对象中不存在。计数为 0 表示覆盖查询没有匹配的交换机或返回零库存；这并不证明所有供应商或其他发现途径都没有号码。

示例性响应形状；并非实时账户数据或当前报价。

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

错误

404: 提供商已禁用：该服务上的移动库存覆盖不可用。
404: 无效的前缀 ID：请从发现结果获取当前的单个前缀 ID。
404: 无效前缀：存储的前缀未包含足够数字以进行 NPA/NXX 查询。
500: 库存覆盖失败：上游查询未返回成功的覆盖结果。请稍后通过退避策略重试；失败并不表示库存计数为零。

可用性与副作用

该操作检查库存，不下单、不保留号码，也不扣减购买金额。
库存可能立即变化。覆盖计数并未调整以承诺特定账户的可购买性或与下一次号码搜索响应相同的长度。
查询会联系覆盖服务并可能需要时间。请勿对每个前缀重复轮询，也不要将超时/错误视为成功的零库存。