查询静态订单列表
按业务编号或来源查询当前账户的静态订单。
只只HTTP技术团队维护更新于 2026年10月6日
接口与认证
GET
/openapi/v1/static/orders按客户订单编号查询订单。仅访问当前令牌账户的数据。
使用 HTTPS 和账户 API 令牌。响应包含 Cache-Control: no-store 和 X-Request-Id。
示例为合成数据与占位凭据,仅说明结构。接口合同不代表目标环境已开放,开放状态以控制台为准。
下载 OpenAPI · 导入 Apifox / Postman请求参数
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
api_key | string | 是 | Query · 唯一非空 | 账户 API 令牌,在受控服务端保存;示例使用占位符。 |
page | integer | 否 | query · 默认 1;最小 1 | 页码,从 1 开始,默认 1。 |
pageSize | integer | 否 | query · 默认 20;最小 1;最大 100 | 每页数量,默认 20;最大值见字段限制。 |
clientOrderNo | string | 否 | query · — | 客户订单编号,1–64 位字母、数字、_、.、-;同一账户重复提交相同编号和参数时返回原结果。 |
source | string | 否 | query · 枚举 console / admin / api | 订单来源:console 控制台、admin 后台、api 公开 API。 |
无请求体。
请求示例
curl --request GET \
"https://api.zzhttp.com/openapi/v1/static/orders?api_key=${STATIC_API_KEY}&page=1&pageSize=20"成功响应
成功
响应不包含代理密码,凭据仅由专用接口返回。
| 字段 | 类型 | 必填 | 默认值 / 限制 | 说明 |
|---|---|---|---|---|
code | integer | 是 | 固定 200 | 统一数字业务码:HTTP 与业务码成功均为 200;异步受理不代表交付完成。 |
message | string | 是 | — | 服务端结果说明。 |
requestId | string | 是 | — | 本次请求的追踪 ID,用于排障,不是业务幂等编号。 |
data | object | 是 | — | 本接口业务数据。 |
data.items | object[] | 是 | — | 结果或提交明细数组,具体字段见下级。 |
data.items[].orderNo | string | 是 | — | 平台订单号;查询筛选时精确匹配本人订单。 |
data.items[].clientOrderNo | string | 是 | — | 客户订单编号,1–64 位字母、数字、_、.、-;同一账户重复提交相同编号和参数时返回原结果。 |
data.items[].kind | string | 是 | — | 请求类型或订单类型:purchase 采购,renew 续费;订单可能包含其他已支持操作类型。 |
data.items[].status | string | 是 | 枚举 accepted / processing / succeeded / partial / failed / manual_review | 当前状态;枚举见限制,按逐项结果确认终态。 |
data.items[].totalAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].currency | string | 是 | 固定 CNY | 金额币种,当前合同为 CNY。 |
data.items[].settlement | object | 是 | — | 逐订单资金结算;钱包原冻结 = 当前冻结 + 已扣 + 已释放。 |
data.items[].settlement.fundingSource | string | 否 | 枚举 wallet / external / none | 资金来源:wallet 钱包,external 历史外部支付,none 未付款或免费。 |
data.items[].settlement.external | object | 否 | — | 历史外部支付结算信息,不能把应退当已退。 |
data.items[].settlement.external.paidAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.external.capturedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.external.unsettledAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.external.refundDueAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.external.refundedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.external.refundPendingAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.reservedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.frozenAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.capturedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.releasedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.gift | object | 否 | — | 赠送余额的冻结、扣除与释放。 |
data.items[].settlement.gift.reservedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.gift.capturedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.gift.releasedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.recharge | object | 否 | — | 充值余额的冻结、扣除与释放。 |
data.items[].settlement.recharge.reservedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.recharge.capturedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].settlement.recharge.releasedAmountCents | integer | 否 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].items | object[] | 是 | — | 结果或提交明细数组,具体字段见下级。 |
data.items[].items[].itemId | integer | 是 | 最小 1;格式 int64 | 订单项 ID。 |
data.items[].items[].offerId | integer | 是 | 最小 1;格式 int64 | 当前可采购商品 ID,来自商品列表。 |
data.items[].items[].status | string | 是 | 枚举 accepted / processing / succeeded / partial / failed / manual_review | 当前状态;枚举见限制,按逐项结果确认终态。 |
data.items[].items[].requestedQuantity | integer | 是 | 最小 0;格式 int64 | 订单项请求数量。 |
data.items[].items[].deliveredQuantity | integer | 是 | 最小 0;格式 int64 | 已交付数量。 |
data.items[].items[].durationDays | integer | 是 | 最小 0;格式 int64 | 期限天数;须满足商品/实例 capabilities 中对应期限规则。 |
data.items[].items[].unitPriceCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].items[].totalAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].items[].pricingSource | string | 是 | — | 价格来源:customer 客户价格,retail 零售价。 |
data.items[].items[].frozenAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].items[].capturedAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].items[].releasedAmountCents | integer | 是 | 最小 0;格式 int64 | 人民币整数分 |
data.items[].items[].instanceIds | integer[] | 是 | — | 本人实例 ID 数组,每次 1–100 项;任一实例无效则整批拒绝。 |
data.items[].items[].errorCode | string | 是 | — | 逐项原因:OUT_OF_STOCK、SERVICE_UNAVAILABLE、RESULT_UNCONFIRMED、FULFILLMENT_FAILED;成功为空字符串。 |
data.items[].items[].errorMessage | string | 否 | — | 失败原因说明。 |
data.items[].items[].nextAction | string | 否 | 枚举 / check_inventory / query_order / contact_support | 建议下一步;结果不确定时只能查原单。 |
data.items[].createdAt | string | null | 是 | 格式 date-time | 创建时间,RFC3339。 |
data.items[].completedAt | string | null | 是 | 格式 date-time | 完成时间,RFC3339;未结束为 null。 |
data.items[].queryUrl | string | 是 | — | 轮询查询的相对路径,仍需附加 api_key 认证。 |
data.items[].source | string | 是 | 枚举 console / admin / api | 下单来源:用户控制台、后台管理、公开API |
data.items[].operationId | integer | 否 | 最小 1;格式 int64 | 关联收费操作ID;无关联时省略 |
data.items[].clientOperationNo | string | 否 | — | 关联收费操作的客户业务号;无关联时省略 |
data.page | integer | 是 | 最小 0;格式 int64 | 页码,从 1 开始,默认 1。 |
data.pageSize | integer | 是 | 最小 0;格式 int64 | 每页数量,默认 20;最大值见字段限制。 |
data.total | integer | 是 | 最小 0;格式 int64 | 筛选后的总记录数,不是当前页条数。 |
{
"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 状态、错误响应字段及恢复方式统一见错误码与处理建议。
这篇内容解决了你的问题吗?
反馈只用于改进公开文档,不会提交账号或请求信息。