读取已保存的价格方案
在浏览可用电话号码后,查询为您的 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 限制和数据库故障也可能导致无法获得可用响应。对于数据库异常,没有处理程序专属的错误封装。当经认证的查询持续不可用时,请刷新您的选择或联系支持。
影响与限制
经审核的查询执行的是读取查询,不包含任何扣款、购买、预留或供应商价格刷新。读取已保存定价并不能确立当前库存、监管批准、账户购买权限或最终计费。