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

查询静态商品

查询当前账户可见商品、客户价格及库存快照。

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

接口与认证

GET/openapi/v1/static/offers

查询客户商品和库存快照。仅访问当前令牌账户的数据。

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

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

下载 OpenAPI · 导入 Apifox / Postman

请求参数

查询与路径参数
字段类型必填默认值 / 限制说明
api_keystring是Query · 唯一非空账户 API 令牌,在受控服务端保存;示例使用占位符。
countryCodestring否query · —国家三字码,例如 USA;使用国家目录返回值。
cityCodestring否query · —城市编码,使用城市目录返回值。
ispTypeinteger否query · 枚举 1 / 2IP 类型:1 原生IP,2 独享IP;与控制台销售类型一致。

无请求体。

请求示例

Shell · STATIC_API_KEY 使用账户令牌
curl --request GET \
  "https://api.zzhttp.com/openapi/v1/static/offers?api_key=${STATIC_API_KEY}"

成功响应

成功

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

响应字段(含嵌套字段)
字段类型必填默认值 / 限制说明
codeinteger是固定 200统一数字业务码:HTTP 与业务码成功均为 200;异步受理不代表交付完成。
messagestring是—服务端结果说明。
requestIdstring是—本次请求的追踪 ID,用于排障,不是业务幂等编号。
dataobject是—本接口业务数据。
data.itemsobject[]是—结果或提交明细数组,具体字段见下级。
data.items[].offerIdinteger是最小 1;格式 int64当前可采购商品 ID,来自商品列表。
data.items[].ispTypenumber是枚举 1 / 2IP 类型:1 原生IP,2 独享IP;与控制台销售类型一致。
data.items[].countryCodestring是—国家三字码,例如 USA;使用国家目录返回值。
data.items[].cityCodestring是—城市编码,使用城市目录返回值。
data.items[].durationDaysinteger是最小 0;格式 int64商品单价对应的基准周期,当前为30天;实际采购时长由采购项 durationDays 选择。
data.items[].unitPriceCentsinteger是最小 0;格式 int64基准周期每个IP的客户价格,人民币整数分;采购周期价以报价结果为准。
data.items[].currencystring是固定 CNY金额币种,当前合同为 CNY。
data.items[].pricingSourcestring是枚举 customer / retail价格来源:customer 客户价格,retail 零售价。
data.items[].availableCountinteger是最小 0;格式 int64最近同步的可售库存;报价和下单会再次校验。
data.items[].inventorySyncedAtstring | null是格式 date-time库存同步时间,RFC3339;未同步为 null。
data.items[].purchasableboolean是—当前是否可采购。
data.items[].capabilitiesobject是—真实货源或实例能力;声明不替代提交时业务校验,缺失快照可为空对象。
data.items[].capabilities.purchaseobject否—采购期限规则。
data.items[].capabilities.purchase.allowedDaysinteger[]否—允许的期限天数集合;非空时优先采用该集合。
data.items[].capabilities.purchase.minDaysinteger否最小 0无 allowedDays 集合时的最短期限。
data.items[].capabilities.purchase.maxDaysinteger否最小 0最长期限,0 表示不设上限。
data.items[].capabilities.purchase.stepDaysinteger否最小 0从最短期限起允许的增量天数。
data.items[].capabilities.renewobject否—续费期限规则。
data.items[].capabilities.renew.allowedDaysinteger[]否—允许的期限天数集合;非空时优先采用该集合。
data.items[].capabilities.renew.minDaysinteger否最小 0无 allowedDays 集合时的最短期限。
data.items[].capabilities.renew.maxDaysinteger否最小 0最长期限,0 表示不设上限。
data.items[].capabilities.renew.stepDaysinteger否最小 0从最短期限起允许的增量天数。
data.items[].capabilities.convertTrialobject否—试用转正式期限规则。
data.items[].capabilities.convertTrial.allowedDaysinteger[]否—允许的期限天数集合;非空时优先采用该集合。
data.items[].capabilities.convertTrial.minDaysinteger否最小 0无 allowedDays 集合时的最短期限。
data.items[].capabilities.convertTrial.maxDaysinteger否最小 0最长期限,0 表示不设上限。
data.items[].capabilities.convertTrial.stepDaysinteger否最小 0从最短期限起允许的增量天数。
data.items[].capabilities.trialDaysinteger否最小 0试用期限天数;0 表示不提供试用。
data.items[].capabilities.changeIpboolean否—是否支持换 IP。
data.items[].capabilities.selectReplacementboolean否—是否支持选择替换节点。
data.items[].capabilities.customCredentialsboolean否—是否支持客户指定账密。
data.items[].capabilities.randomCredentialsboolean否—是否支持随机生成账密。
data.items[].capabilities.maxBatchSizeinteger否最小 0货源能力声明的批量上限;服务端请求限制仍适用。
data.inventorySyncedAtstring | null是格式 date-time库存同步时间,RFC3339;未同步为 null。
JSON · HTTP 200
{
  "code": 200,
  "message": "成功",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "data": {
    "items": [
      {
        "offerId": 17,
        "ispType": 1,
        "countryCode": "USA",
        "cityCode": "NYC",
        "durationDays": 30,
        "unitPriceCents": 3500,
        "currency": "CNY",
        "pricingSource": "retail",
        "availableCount": 100,
        "inventorySyncedAt": "2026-10-06T08:00:00Z",
        "purchasable": false,
        "capabilities": {
          "purchase": {
            "minDays": 30,
            "maxDays": 360,
            "stepDays": 30
          },
          "renew": {
            "allowedDays": [
              30
            ]
          },
          "convertTrial": {},
          "trialDays": 0,
          "changeIp": false,
          "selectReplacement": false,
          "customCredentials": true,
          "randomCredentials": true,
          "maxBatchSize": 100
        }
      }
    ],
    "inventorySyncedAt": "2026-10-06T08:00:00Z"
  }
}

错误与重试

读取请求遇到业务码 10713 按 Retry-After 等待;500 可有限重试。分组创建结果不明时先查询分组列表;移动同一目标可安全重试。

错误码、HTTP 状态、错误响应字段及恢复方式统一见错误码与处理建议。

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

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