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

查询静态订单列表

按业务编号或来源查询当前账户的静态订单。

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

接口与认证

GET/openapi/v1/static/orders

按客户订单编号查询订单。仅访问当前令牌账户的数据。

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

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

下载 OpenAPI · 导入 Apifox / Postman

请求参数

查询与路径参数
字段类型必填默认值 / 限制说明
api_keystring是Query · 唯一非空账户 API 令牌,在受控服务端保存;示例使用占位符。
pageinteger否query · 默认 1;最小 1页码,从 1 开始,默认 1。
pageSizeinteger否query · 默认 20;最小 1;最大 100每页数量,默认 20;最大值见字段限制。
clientOrderNostring否query · —客户订单编号,1–64 位字母、数字、_、.、-;同一账户重复提交相同编号和参数时返回原结果。
sourcestring否query · 枚举 console / admin / api订单来源:console 控制台、admin 后台、api 公开 API。

无请求体。

请求示例

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

成功响应

成功

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

响应字段(含嵌套字段)
字段类型必填默认值 / 限制说明
codeinteger是固定 200统一数字业务码:HTTP 与业务码成功均为 200;异步受理不代表交付完成。
messagestring是—服务端结果说明。
requestIdstring是—本次请求的追踪 ID,用于排障,不是业务幂等编号。
dataobject是—本接口业务数据。
data.itemsobject[]是—结果或提交明细数组,具体字段见下级。
data.items[].orderNostring是—平台订单号;查询筛选时精确匹配本人订单。
data.items[].clientOrderNostring是—客户订单编号,1–64 位字母、数字、_、.、-;同一账户重复提交相同编号和参数时返回原结果。
data.items[].kindstring是—请求类型或订单类型:purchase 采购,renew 续费;订单可能包含其他已支持操作类型。
data.items[].statusstring是枚举 accepted / processing / succeeded / partial / failed / manual_review当前状态;枚举见限制,按逐项结果确认终态。
data.items[].totalAmountCentsinteger是最小 0;格式 int64人民币整数分
data.items[].currencystring是固定 CNY金额币种,当前合同为 CNY。
data.items[].settlementobject是—逐订单资金结算;钱包原冻结 = 当前冻结 + 已扣 + 已释放。
data.items[].settlement.fundingSourcestring否枚举 wallet / external / none资金来源:wallet 钱包,external 历史外部支付,none 未付款或免费。
data.items[].settlement.externalobject否—历史外部支付结算信息,不能把应退当已退。
data.items[].settlement.external.paidAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.external.capturedAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.external.unsettledAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.external.refundDueAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.external.refundedAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.external.refundPendingAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.reservedAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.frozenAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.capturedAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.releasedAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.giftobject否—赠送余额的冻结、扣除与释放。
data.items[].settlement.gift.reservedAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.gift.capturedAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.gift.releasedAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.rechargeobject否—充值余额的冻结、扣除与释放。
data.items[].settlement.recharge.reservedAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.recharge.capturedAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].settlement.recharge.releasedAmountCentsinteger否最小 0;格式 int64人民币整数分
data.items[].itemsobject[]是—结果或提交明细数组,具体字段见下级。
data.items[].items[].itemIdinteger是最小 1;格式 int64订单项 ID。
data.items[].items[].offerIdinteger是最小 1;格式 int64当前可采购商品 ID,来自商品列表。
data.items[].items[].statusstring是枚举 accepted / processing / succeeded / partial / failed / manual_review当前状态;枚举见限制,按逐项结果确认终态。
data.items[].items[].requestedQuantityinteger是最小 0;格式 int64订单项请求数量。
data.items[].items[].deliveredQuantityinteger是最小 0;格式 int64已交付数量。
data.items[].items[].durationDaysinteger是最小 0;格式 int64期限天数;须满足商品/实例 capabilities 中对应期限规则。
data.items[].items[].unitPriceCentsinteger是最小 0;格式 int64人民币整数分
data.items[].items[].totalAmountCentsinteger是最小 0;格式 int64人民币整数分
data.items[].items[].pricingSourcestring是—价格来源:customer 客户价格,retail 零售价。
data.items[].items[].frozenAmountCentsinteger是最小 0;格式 int64人民币整数分
data.items[].items[].capturedAmountCentsinteger是最小 0;格式 int64人民币整数分
data.items[].items[].releasedAmountCentsinteger是最小 0;格式 int64人民币整数分
data.items[].items[].instanceIdsinteger[]是—本人实例 ID 数组,每次 1–100 项;任一实例无效则整批拒绝。
data.items[].items[].errorCodestring是—逐项原因:OUT_OF_STOCK、SERVICE_UNAVAILABLE、RESULT_UNCONFIRMED、FULFILLMENT_FAILED;成功为空字符串。
data.items[].items[].errorMessagestring否—失败原因说明。
data.items[].items[].nextActionstring否枚举 / check_inventory / query_order / contact_support建议下一步;结果不确定时只能查原单。
data.items[].createdAtstring | null是格式 date-time创建时间,RFC3339。
data.items[].completedAtstring | null是格式 date-time完成时间,RFC3339;未结束为 null。
data.items[].queryUrlstring是—轮询查询的相对路径,仍需附加 api_key 认证。
data.items[].sourcestring是枚举 console / admin / api下单来源:用户控制台、后台管理、公开API
data.items[].operationIdinteger否最小 1;格式 int64关联收费操作ID;无关联时省略
data.items[].clientOperationNostring否—关联收费操作的客户业务号;无关联时省略
data.pageinteger是最小 0;格式 int64页码,从 1 开始,默认 1。
data.pageSizeinteger是最小 0;格式 int64每页数量,默认 20;最大值见字段限制。
data.totalinteger是最小 0;格式 int64筛选后的总记录数,不是当前页条数。
JSON · HTTP 200
{
  "code": 200,
  "message": "成功",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "data": {
    "items": [
      {
        "orderNo": "STATIC-DEMO-001",
        "clientOrderNo": "platform-order-001",
        "kind": "purchase",
        "status": "succeeded",
        "totalAmountCents": 3500,
        "currency": "CNY",
        "settlement": {
          "fundingSource": "wallet",
          "reservedAmountCents": 3500,
          "frozenAmountCents": 0,
          "capturedAmountCents": 3500,
          "releasedAmountCents": 0,
          "gift": {
            "reservedAmountCents": 0,
            "capturedAmountCents": 0,
            "releasedAmountCents": 0
          },
          "recharge": {
            "reservedAmountCents": 3500,
            "capturedAmountCents": 3500,
            "releasedAmountCents": 0
          }
        },
        "items": [
          {
            "itemId": 201,
            "offerId": 17,
            "status": "succeeded",
            "requestedQuantity": 1,
            "deliveredQuantity": 1,
            "durationDays": 30,
            "unitPriceCents": 3500,
            "totalAmountCents": 3500,
            "pricingSource": "retail",
            "frozenAmountCents": 0,
            "capturedAmountCents": 3500,
            "releasedAmountCents": 0,
            "instanceIds": [
              101
            ],
            "errorCode": "",
            "errorMessage": "",
            "nextAction": ""
          }
        ],
        "createdAt": "2026-10-06T08:00:00Z",
        "completedAt": "2026-10-06T08:00:00Z",
        "queryUrl": "/openapi/v1/static/orders/STATIC-DEMO-001",
        "source": "api"
      }
    ],
    "page": 1,
    "pageSize": 20,
    "total": 1
  }
}

错误与重试

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

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

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

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