查询静态商品
查询当前账户可见商品、客户价格及库存快照。
只只HTTP技术团队维护更新于 2026年10月7日
接口与认证
GET
/openapi/v1/static/offers查询客户商品和库存快照。仅访问当前令牌账户的数据。
使用 HTTPS 和账户 API 令牌。响应包含 Cache-Control: no-store 和 X-Request-Id。
示例为合成数据与占位凭据,仅说明结构。接口合同不代表目标环境已开放,开放状态以控制台为准。
下载 OpenAPI · 导入 Apifox / Postman请求参数
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
api_key | string | 是 | Query · 唯一非空 | 账户 API 令牌,在受控服务端保存;示例使用占位符。 |
countryCode | string | 否 | query · — | 国家三字码,例如 USA;使用国家目录返回值。 |
cityCode | string | 否 | query · — | 城市编码,使用城市目录返回值。 |
ispType | integer | 否 | query · 枚举 1 / 2 | IP 类型:1 原生IP,2 独享IP;与控制台销售类型一致。 |
无请求体。
请求示例
curl --request GET \
"https://api.zzhttp.com/openapi/v1/static/offers?api_key=${STATIC_API_KEY}"成功响应
成功
响应不包含代理密码,凭据仅由专用接口返回。
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
code | integer | 是 | 固定 200 | 统一数字业务码:HTTP 与业务码成功均为 200;异步受理不代表交付完成。 |
message | string | 是 | — | 服务端结果说明。 |
requestId | string | 是 | — | 本次请求的追踪 ID,用于排障,不是业务幂等编号。 |
data | object | 是 | — | 本接口业务数据。 |
data.items | object[] | 是 | — | 结果或提交明细数组,具体字段见下级。 |
data.items[].offerId | integer | 是 | 最小 1;格式 int64 | 当前可采购商品 ID,来自商品列表。 |
data.items[].ispType | number | 是 | 枚举 1 / 2 | IP 类型:1 原生IP,2 独享IP;与控制台销售类型一致。 |
data.items[].countryCode | string | 是 | — | 国家三字码,例如 USA;使用国家目录返回值。 |
data.items[].cityCode | string | 是 | — | 城市编码,使用城市目录返回值。 |
data.items[].durationDays | integer | 是 | 最小 0;格式 int64 | 商品单价对应的基准周期,当前为30天;实际采购时长由采购项 durationDays 选择。 |
data.items[].unitPriceCents | integer | 是 | 最小 0;格式 int64 | 基准周期每个IP的客户价格,人民币整数分;采购周期价以报价结果为准。 |
data.items[].currency | string | 是 | 固定 CNY | 金额币种,当前合同为 CNY。 |
data.items[].pricingSource | string | 是 | 枚举 customer / retail | 价格来源:customer 客户价格,retail 零售价。 |
data.items[].availableCount | integer | 是 | 最小 0;格式 int64 | 最近同步的可售库存;报价和下单会再次校验。 |
data.items[].inventorySyncedAt | string | null | 是 | 格式 date-time | 库存同步时间,RFC3339;未同步为 null。 |
data.items[].purchasable | boolean | 是 | — | 当前是否可采购。 |
data.items[].capabilities | object | 是 | — | 真实货源或实例能力;声明不替代提交时业务校验,缺失快照可为空对象。 |
data.items[].capabilities.purchase | object | 否 | — | 采购期限规则。 |
data.items[].capabilities.purchase.allowedDays | integer[] | 否 | — | 允许的期限天数集合;非空时优先采用该集合。 |
data.items[].capabilities.purchase.minDays | integer | 否 | 最小 0 | 无 allowedDays 集合时的最短期限。 |
data.items[].capabilities.purchase.maxDays | integer | 否 | 最小 0 | 最长期限,0 表示不设上限。 |
data.items[].capabilities.purchase.stepDays | integer | 否 | 最小 0 | 从最短期限起允许的增量天数。 |
data.items[].capabilities.renew | object | 否 | — | 续费期限规则。 |
data.items[].capabilities.renew.allowedDays | integer[] | 否 | — | 允许的期限天数集合;非空时优先采用该集合。 |
data.items[].capabilities.renew.minDays | integer | 否 | 最小 0 | 无 allowedDays 集合时的最短期限。 |
data.items[].capabilities.renew.maxDays | integer | 否 | 最小 0 | 最长期限,0 表示不设上限。 |
data.items[].capabilities.renew.stepDays | integer | 否 | 最小 0 | 从最短期限起允许的增量天数。 |
data.items[].capabilities.convertTrial | object | 否 | — | 试用转正式期限规则。 |
data.items[].capabilities.convertTrial.allowedDays | integer[] | 否 | — | 允许的期限天数集合;非空时优先采用该集合。 |
data.items[].capabilities.convertTrial.minDays | integer | 否 | 最小 0 | 无 allowedDays 集合时的最短期限。 |
data.items[].capabilities.convertTrial.maxDays | integer | 否 | 最小 0 | 最长期限,0 表示不设上限。 |
data.items[].capabilities.convertTrial.stepDays | integer | 否 | 最小 0 | 从最短期限起允许的增量天数。 |
data.items[].capabilities.trialDays | integer | 否 | 最小 0 | 试用期限天数;0 表示不提供试用。 |
data.items[].capabilities.changeIp | boolean | 否 | — | 是否支持换 IP。 |
data.items[].capabilities.selectReplacement | boolean | 否 | — | 是否支持选择替换节点。 |
data.items[].capabilities.customCredentials | boolean | 否 | — | 是否支持客户指定账密。 |
data.items[].capabilities.randomCredentials | boolean | 否 | — | 是否支持随机生成账密。 |
data.items[].capabilities.maxBatchSize | integer | 否 | 最小 0 | 货源能力声明的批量上限;服务端请求限制仍适用。 |
data.inventorySyncedAt | string | null | 是 | 格式 date-time | 库存同步时间,RFC3339;未同步为 null。 |
{
"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 状态、错误响应字段及恢复方式统一见错误码与处理建议。
这篇内容解决了你的问题吗?
反馈只用于改进公开文档,不会提交账号或请求信息。