跳转到主要内容
GET
带宽报价

带宽报价

返回该数量和时长的带宽订单将实际扣除的准确金额——租赁费与固定手续费合计,按您的费率计算。报价与订单扣费由同一段代码计算,因此在价格不变期间,购买费用恰好等于 total_trx。 此端点为公开接口——身份验证为可选。 传入您的 API 密钥可按您自己的费率和固定手续费报价;不传则返回公开价格。
向您的用户展示 total_trx,并将其作为 max_price_trx 传给购买带宽。如果在报价与购买之间价格发生变化,购买将以 409 PRICE_CHANGED 被拒绝,且不会扣除任何费用——请重新报价并重试。

查询参数

integer
必填
需要报价的带宽单位数。范围 1 至 100,000。
string
默认值:"1h"
租赁时长:1h、1d,或 5m 至 59m 之间的整数分钟——取值与购买带宽相同。

请求头

string
可选。使用有效密钥时,响应会反映您协商的费率和您的固定手续费。缺失、无效或已吊销的密钥不算错误——您会得到公开价格,且 personal_price: false。

响应

number
本次报价所针对的带宽单位数
string
本次报价所针对的租赁时长
string
每 1 单位带宽的费率(SUN),为便于展示四舍五入到 0.01。分钟时长带有折扣,因此其费率是小数,而下列金额按精确费率计算——请直接使用 total_trx,不要自己用这个取整后的值相乘。
string
该数量和时长的租赁费用,不含固定手续费
string
固定手续费,每笔订单收取一次,与数量和时长无关。若您的账户设有专属手续费、折扣或豁免,此处会体现您的实际手续费。
string
将要扣除的金额:rental_trx + fixed_fee_trx。请将其作为 max_price_trx 传给购买带宽。
boolean
应用了您协商的费率时为 true,按公开价格报价时为 false。请检查该字段:否则遗漏 X-API-Key 请求头的响应看起来与正常响应无异,您会按公开价向客户报价,而实际按您自己的价格扣费。

示例

以下数值仅为示例,按 price_sun_1h 为 400、short_max_discount_pct 为 5 计算。当前费率和折扣请参见获取带宽价格。
Response

报价不包含的内容

报价——以及 max_price_trx——仅涵盖带宽订单。如果目标地址在链上尚未激活,购买带宽会激活该地址,并另行收取激活费用(其响应中的 activation_cost_trx)。该费用不计入 total_trx,也不会与 max_price_trx 进行比较。

代表其他账户操作: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。