核心 API
带宽报价
指定数量和时长的带宽订单的准确价格,已包含固定手续费
GET
带宽报价
带宽报价
返回该数量和时长的带宽订单将实际扣除的准确金额——租赁费与固定手续费合计,按您的费率计算。报价与订单扣费由同一段代码计算,因此在价格不变期间,购买费用恰好等于total_trx。
此端点为公开接口——身份验证为可选。 传入您的 API 密钥可按您自己的费率和固定手续费报价;不传则返回公开价格。
查询参数
integer
必填
需要报价的带宽单位数。范围 1 至 100,000。
请求头
string
可选。使用有效密钥时,响应会反映您协商的费率和您的固定手续费。缺失、无效或已吊销的密钥不算错误——您会得到公开价格,且
personal_price: false。响应
number
本次报价所针对的带宽单位数
string
本次报价所针对的租赁时长
string
每 1 单位带宽的费率(SUN),为便于展示四舍五入到 0.01。分钟时长带有折扣,因此其费率是小数,而下列金额按精确费率计算——请直接使用
total_trx,不要自己用这个取整后的值相乘。string
该数量和时长的租赁费用,不含固定手续费
string
固定手续费,每笔订单收取一次,与数量和时长无关。若您的账户设有专属手续费、折扣或豁免,此处会体现您的实际手续费。
boolean
应用了您协商的费率时为
true,按公开价格报价时为 false。请检查该字段:否则遗漏 X-API-Key 请求头的响应看起来与正常响应无异,您会按公开价向客户报价,而实际按您自己的价格扣费。示例
以下数值仅为示例,按
price_sun_1h 为 400、short_max_discount_pct 为 5 计算。当前费率和折扣请参见获取带宽价格。Response
报价不包含的内容
代表其他账户操作:GET /v1/bandwidth/quote/me
/bandwidth/quote 按 API 密钥所有者的价格报价。如果您的密钥通过 X-Account-Id 请求头代表其他账户操作,购买将按该账户的费率和手续费扣费——报价可能与实际扣费不同,据此得到的 max_price_trx 可能会以 409 PRICE_CHANGED 被拒绝。
这种情况下请使用 GET /v1/bandwidth/quote/me。它接受相同的查询参数并返回相同的响应,但需要身份验证,且账户的确定方式与购买时完全相同,包括 X-Account-Id。它需要 view 权限,而每个密钥始终具备该权限。
cURL
错误
在
/bandwidth/quote 上,无效或已吊销的 X-API-Key 不是错误:仍会按公开价格返回报价,且 personal_price: false。