跳到正文
本中心目录
API 文档 · 静态 IP 功能

获取静态报价

计算采购或续费报价,不冻结余额与库存。

只只HTTP技术团队维护更新于 2026年10月7日

接口与认证

POST/openapi/v1/static/quotes

报价不冻结资金或库存。仅访问当前令牌账户的数据。

使用 HTTPS 和账户 API 令牌。响应包含 Cache-Control: no-store 和 X-Request-Id。

示例为合成数据与占位凭据,仅说明结构。接口合同不代表目标环境已开放,开放状态以控制台为准。

下载 OpenAPI · 导入 Apifox / Postman

请求参数

查询与路径参数
字段类型必填默认值 / 限制说明
api_keystring是Query · 唯一非空账户 API 令牌,在受控服务端保存;示例使用占位符。

purchase · application/json

purchase
字段类型必填默认值 / 限制说明
kindstring是固定 purchase请求类型或订单类型:purchase 采购,renew 续费;订单可能包含其他已支持操作类型。
itemsobject[]是最少项 1;最多项 100结果或提交明细数组,具体字段见下级。
items[].offerIdinteger是最小 1;格式 int64当前可采购商品 ID,来自商品列表。
items[].quantityinteger是最小 1;最大 1000该商品采购数量,1–1000;还需满足可售库存与货源能力。
items[].durationDaysinteger否默认 30;最小 30;最大 360采购时长(天);省略为30,范围30–360,须满足商品 capabilities.purchase;采购期限须为30天倍数。

renew · application/json

renew
字段类型必填默认值 / 限制说明
kindstring是固定 renew请求类型或订单类型:purchase 采购,renew 续费;订单可能包含其他已支持操作类型。
instanceIdsinteger[]是最少项 1;最多项 100本人实例 ID 数组,每次 1–100 项;任一实例无效则整批拒绝。
durationDaysinteger是最小 1;最大 3650期限天数;须满足商品/实例 capabilities 中对应期限规则。

请求示例

Shell · STATIC_API_KEY 使用账户令牌
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}]}'

成功响应

成功

响应不包含代理密码,凭据仅由专用接口返回。

响应字段(含嵌套字段)
字段类型必填默认值 / 限制说明
codeinteger是固定 200统一数字业务码:HTTP 与业务码成功均为 200;异步受理不代表交付完成。
messagestring是—服务端结果说明。
requestIdstring是—本次请求的追踪 ID,用于排障,不是业务幂等编号。
dataobject是—本接口业务数据。
data.kindstring是枚举 purchase / renew请求类型或订单类型:purchase 采购,renew 续费;订单可能包含其他已支持操作类型。
data.currencystring是固定 CNY金额币种,当前合同为 CNY。
data.itemsobject[]是—报价明细;采购项含 offerId,续费项含 instanceId。
data.items[].offerIdinteger否最小 1;格式 int64当前可采购商品 ID,来自商品列表。
data.items[].instanceIdinteger否最小 1;格式 int64实例 ID,属于当前账户;分组绑定此 ID。
data.items[].quantityinteger否最小 0;格式 int64该商品采购数量,1–1000;还需满足可售库存与货源能力。
data.items[].durationDaysinteger否最小 0;格式 int64期限天数;须满足商品/实例 capabilities 中对应期限规则。
data.items[].unitPriceCentsinteger否最小 0;格式 int64人民币整数分
data.items[].amountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].pricingSourcestring否—价格来源:customer 客户价格,retail 零售价。
data.totalAmountCentsinteger是最小 0;格式 int64人民币整数分
data.quotedAtstring | null是格式 date-time报价时间,RFC3339。
data.inventoryReservedboolean是固定 false报价不会预留库存,固定为 false。
JSON · HTTP 200
{
  "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 状态、错误响应字段及恢复方式统一见错误码与处理建议。

这篇内容解决了你的问题吗?

反馈只用于改进公开文档,不会提交账号或请求信息。