获取静态报价
计算采购或续费报价,不冻结余额与库存。
只只HTTP技术团队维护更新于 2026年10月7日
接口与认证
POST
/openapi/v1/static/quotes报价不冻结资金或库存。仅访问当前令牌账户的数据。
使用 HTTPS 和账户 API 令牌。响应包含 Cache-Control: no-store 和 X-Request-Id。
示例为合成数据与占位凭据,仅说明结构。接口合同不代表目标环境已开放,开放状态以控制台为准。
下载 OpenAPI · 导入 Apifox / Postman请求参数
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
api_key | string | 是 | Query · 唯一非空 | 账户 API 令牌,在受控服务端保存;示例使用占位符。 |
purchase · application/json
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
kind | string | 是 | 固定 purchase | 请求类型或订单类型:purchase 采购,renew 续费;订单可能包含其他已支持操作类型。 |
items | object[] | 是 | 最少项 1;最多项 100 | 结果或提交明细数组,具体字段见下级。 |
items[].offerId | integer | 是 | 最小 1;格式 int64 | 当前可采购商品 ID,来自商品列表。 |
items[].quantity | integer | 是 | 最小 1;最大 1000 | 该商品采购数量,1–1000;还需满足可售库存与货源能力。 |
items[].durationDays | integer | 否 | 默认 30;最小 30;最大 360 | 采购时长(天);省略为30,范围30–360,须满足商品 capabilities.purchase;采购期限须为30天倍数。 |
renew · application/json
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
kind | string | 是 | 固定 renew | 请求类型或订单类型:purchase 采购,renew 续费;订单可能包含其他已支持操作类型。 |
instanceIds | integer[] | 是 | 最少项 1;最多项 100 | 本人实例 ID 数组,每次 1–100 项;任一实例无效则整批拒绝。 |
durationDays | integer | 是 | 最小 1;最大 3650 | 期限天数;须满足商品/实例 capabilities 中对应期限规则。 |
请求示例
curl --request POST \
"https://api.zzhttp.com/openapi/v1/static/quotes?api_key=${STATIC_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"kind":"purchase","items":[{"offerId":17,"quantity":1,"durationDays":30}]}'成功响应
成功
响应不包含代理密码,凭据仅由专用接口返回。
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
code | integer | 是 | 固定 200 | 统一数字业务码:HTTP 与业务码成功均为 200;异步受理不代表交付完成。 |
message | string | 是 | — | 服务端结果说明。 |
requestId | string | 是 | — | 本次请求的追踪 ID,用于排障,不是业务幂等编号。 |
data | object | 是 | — | 本接口业务数据。 |
data.kind | string | 是 | 枚举 purchase / renew | 请求类型或订单类型:purchase 采购,renew 续费;订单可能包含其他已支持操作类型。 |
data.currency | string | 是 | 固定 CNY | 金额币种,当前合同为 CNY。 |
data.items | object[] | 是 | — | 报价明细;采购项含 offerId,续费项含 instanceId。 |
data.items[].offerId | integer | 否 | 最小 1;格式 int64 | 当前可采购商品 ID,来自商品列表。 |
data.items[].instanceId | integer | 否 | 最小 1;格式 int64 | 实例 ID,属于当前账户;分组绑定此 ID。 |
data.items[].quantity | integer | 否 | 最小 0;格式 int64 | 该商品采购数量,1–1000;还需满足可售库存与货源能力。 |
data.items[].durationDays | integer | 否 | 最小 0;格式 int64 | 期限天数;须满足商品/实例 capabilities 中对应期限规则。 |
data.items[].unitPriceCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].amountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].pricingSource | string | 否 | — | 价格来源:customer 客户价格,retail 零售价。 |
data.totalAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.quotedAt | string | null | 是 | 格式 date-time | 报价时间,RFC3339。 |
data.inventoryReserved | boolean | 是 | 固定 false | 报价不会预留库存,固定为 false。 |
{
"code": 200,
"message": "成功",
"requestId": "00000000-0000-4000-8000-000000000001",
"data": {
"kind": "purchase",
"currency": "CNY",
"items": [
{
"offerId": 17,
"instanceId": 101,
"quantity": 1,
"durationDays": 30,
"unitPriceCents": 3500,
"amountCents": 3500,
"pricingSource": "retail"
}
],
"totalAmountCents": 3500,
"quotedAt": "2026-10-06T08:00:00Z",
"inventoryReserved": false
}
}错误与重试
读取请求遇到业务码 10713 按 Retry-After 等待;500 可有限重试。分组创建结果不明时先查询分组列表;移动同一目标可安全重试。
错误码、HTTP 状态、错误响应字段及恢复方式统一见错误码与处理建议。
这篇内容解决了你的问题吗?
反馈只用于改进公开文档,不会提交账号或请求信息。