开发者

GET/v3/getpriceinfo/{visible_uuid}

读取已保存的号码价格方案

检索账户专属的已保存定价,并在订购前处理过期、空白或含糊的结果。

本页
  1. 读取已保存的价格方案
  2. 请求
  3. 响应
  4. 价格字段
  5. 处理多个匹配行
  6. 空响应与错误
  7. 影响与限制

读取已保存的价格方案

在浏览可用电话号码后,查询为您的 API 账户保存的价格行。请使用价格选项的 uuid(取自所选号码的 price 列表),而不是其号码、前缀 ID 或区域 ID。请将所选号码与价格选项保持对应。

这是对已保存定价的兼容性查询。它不会刷新可用性或价格、预留号码、下达订单,也不保证未来购买的金额。订购前,请结合新的号码搜索核对返回的价格选项。

请求

请通过 HTTPS 从允许的 IP 地址使用您已启用的 API 账户。将 PRICE_ID 设置为您收到的确切价格选项 ID。该方法读取一个路径参数,不读取请求体、日期或分页参数。

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

必须由获取该价格选项的同一账户执行此查询。请勿自行构造 ID、使用数据库行号或替换为其他账户的选择。该旧版方法仅匹配可见的价格 ID。

响应

以下虚构示例仅显示部分面向客户的字段。实际响应会返回完整的已保存行,并且可能包含额外的账户、供应商和内部定价元数据。请将完整响应保留在您的服务器上,仅公开您的应用程序所需的面向客户的值。

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "visible_uuid": "PRICE_FROM_SEARCH",
      "setup_price": "2.00",
      "monthly_price": "4.50",
      "per_minute": "0.0100",
      "free_minutes": "100",
      "channels": "2"
    }
  ]
}

response 是一个列表,即使只有一行也是如此。status.results 统计返回的行数。数据库数值可能为字符串。该端点不会添加货币字段或进行货币换算;请确认账户的计费货币,而不要从此示例中推断。

价格字段

部分价格方案字段
字段含义
visible_uuid已保存价格选项的可见标识符。关联查询时请使用原始选项 ID。
setup_price此选项存储的一次性开通价格。
monthly_price存储的按月循环价格。
per_minute, free_minutes存储的来电每分钟费率和包含的分钟数。这些不报价呼出通话,也不涵盖所有可能的附加费。
channels此选项存储的通道数量;它不是实时容量或注册检查。
yearly_price可能存在额外存储的年价字段。请勿将非零的月价与为零的年价字段推断为免费的年度方案。

处理多个匹配行

一次查询可能返回多个已保存行。该方法不提供保证的排序、最新行选择或号码/前缀筛选。请勿默默选择第一行或最后一行。请将返回的上下文与原始所选号码和价格选项进行比较;如果仍然含糊或过期,请刷新号码搜索,而不要将此响应视为订单报价。

门户的订单审核流程会执行额外的选择和有效性检查。请勿假定此旧版查询实现了这些检查,或接受门户所接受的每一个标识符。

空响应与错误

如果没有匹配的已保存行,当前处理程序不会输出 JSON 结果,也不会给出明确的未找到响应。空的响应体并不表示价格为零、方案可用或查询确认成功。请同时检查 HTTP 响应和 JSON 结构;请勿基于缺失或无法解析的价格数据下单。

认证、源 IP 限制和数据库故障也可能导致无法获得可用响应。对于数据库异常,没有处理程序专属的错误封装。当经认证的查询持续不可用时,请刷新您的选择或联系支持。

影响与限制

经审核的查询执行的是读取查询,不包含任何扣款、购买、预留或供应商价格刷新。读取已保存定价并不能确立当前库存、监管批准、账户购买权限或最终计费。