创建静态采购订单
购买静态 IP,选择地区、数量和时长,并查看订单结果。
只只HTTP技术团队维护更新于 2026年10月7日
接口与认证
POST
/openapi/v1/static/orders购买静态 IP,可通过 items[].durationDays 选择购买时长,默认30天。可购买时长以商品信息为准,金额以下单结果为准。
使用 HTTPS 和账户 API 令牌。响应包含 Cache-Control: no-store 和 X-Request-Id。
示例为合成数据与占位凭据,仅说明结构。接口合同不代表目标环境已开放,开放状态以控制台为准。
下载 OpenAPI · 导入 Apifox / Postman请求参数
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
api_key | string | 是 | Query · 唯一非空 | 账户 API 令牌,在受控服务端保存;示例使用占位符。 |
请求示例 · application/json
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
clientOrderNo | string | 是 | 格式 ^[A-Za-z0-9_.-]{1,64}$ | 客户订单编号,1–64 位字母、数字、_、.、-;同一账户重复提交相同编号和参数时返回原结果。 |
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天倍数。 |
请求示例
curl --request POST \
"https://api.zzhttp.com/openapi/v1/static/orders?api_key=${STATIC_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"clientOrderNo":"platform-order-001","items":[{"offerId":17,"quantity":1,"durationDays":30}]}'成功响应
正常处理的成功或业务失败;读取 code、data.status 和逐项原因判断结果。
响应不包含代理密码,凭据仅由专用接口返回。
{
"code": 200,
"message": "成功",
"requestId": "00000000-0000-4000-8000-000000000001",
"data": {
"orderNo": "STATIC-DEMO-001",
"clientOrderNo": "platform-order-001",
"kind": "purchase",
"status": "accepted",
"totalAmountCents": 3500,
"currency": "CNY",
"settlement": {
"fundingSource": "wallet",
"reservedAmountCents": 3500,
"frozenAmountCents": 3500,
"capturedAmountCents": 0,
"releasedAmountCents": 0,
"gift": {
"reservedAmountCents": 0,
"capturedAmountCents": 0,
"releasedAmountCents": 0
},
"recharge": {
"reservedAmountCents": 3500,
"capturedAmountCents": 0,
"releasedAmountCents": 0
}
},
"items": [
{
"itemId": 201,
"offerId": 17,
"status": "accepted",
"requestedQuantity": 1,
"deliveredQuantity": 0,
"durationDays": 30,
"unitPriceCents": 3500,
"totalAmountCents": 3500,
"pricingSource": "retail",
"frozenAmountCents": 3500,
"capturedAmountCents": 0,
"releasedAmountCents": 0,
"instanceIds": [],
"errorCode": "",
"errorMessage": "",
"nextAction": ""
}
],
"createdAt": "2026-10-06T08:00:00Z",
"completedAt": null,
"queryUrl": "/openapi/v1/static/orders/STATIC-DEMO-001",
"source": "api"
}
}错误与重试
HTTP 200 / code 200 仅表示受理。超时或 500 先按原 clientOrderNo/clientOperationNo 查询;不要更换编号重复交易。同编号不同参数为 200 / 10705。
错误码、HTTP 状态、错误响应字段及恢复方式统一见错误码与处理建议。
这篇内容解决了你的问题吗?
反馈只用于改进公开文档,不会提交账号或请求信息。