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

创建静态采购订单

购买静态 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_keystring是Query · 唯一非空账户 API 令牌,在受控服务端保存;示例使用占位符。

请求示例 · application/json

请求示例
字段类型必填默认值 / 限制说明
clientOrderNostring是格式 ^[A-Za-z0-9_.-]{1,64}$客户订单编号,1–64 位字母、数字、_、.、-;同一账户重复提交相同编号和参数时返回原结果。
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天倍数。

请求示例

Shell · STATIC_API_KEY 使用账户令牌
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 和逐项原因判断结果。

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

JSON · HTTP 200
{
  "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 状态、错误响应字段及恢复方式统一见错误码与处理建议。

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

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