v1.1.1 更新说明

更新日期：2026-07-05

一句话概览

v1.1.1 调整了 queryOrder 查询订单接口：新增推荐请求字段 cdks，支持一次查询多个 CDK；原 cdk 单个查询字段暂时保留兼容，但后续版本会取消，请新接入方直接使用 cdks。

变化级别

级别	结论	说明
接口路径	不变	仍为 `POST /api/v1/sub/queryOrder`。
请求方法	不变	仍使用 `POST` 和 `application/json` 请求体。
推荐请求字段	新增	新增 `cdks` 数组，推荐所有调用方使用。
旧请求字段	兼容保留	`cdk` 仍可用于单个查询，但已不推荐，后续会取消。
响应结构	扩展	使用 `cdks` 请求时返回 `results` 数组；使用 `cdk` 请求时仍返回旧的单个查询结构。
单次上限	明确	`cdks` 单次最多 50 个有效 CDK。

接口变化

请求参数

推荐请求体：

{
  "cdks": [
    "AUTO-SUB-AAAA1111",
    "AUTO-SUB-BBBB2222"
  ]
}

兼容请求体：

{
  "cdk": "AUTO-SUB-AAAA1111"
}

字段	类型	是否推荐	说明
`cdks`	string[]	推荐	批量查询字段。服务端会去除每个 CDK 的首尾空白并忽略空字符串；单次最多 50 个；重复 CDK 会返回业务失败。
`cdk`	string	不推荐	兼容旧调用的单个 CDK 字段。后续版本会取消，请尽快改为 `cdks`。

批量响应

使用 cdks 请求时，接口返回顶层 results 数组。数组顺序与请求中的有效 CDK 顺序一致。

{
  "code": 200,
  "error": "",
  "results": [
    {
      "cdk": "AUTO-SUB-AAAA1111",
      "code": 200,
      "error": "",
      "cdk_status": "activated",
      "provider": "claude",
      "product_name": "Claude Pro",
      "plan": "claudepro",
      "order": {
        "order_no": "SO202607050001",
        "account": "user@example.com",
        "provider": "claude",
        "status": "success",
        "plan": "claudepro",
        "product_name": "Claude Pro",
        "country": "US",
        "currency": "USD",
        "amount_minor": 2000,
        "error": "",
        "started_at": "2026-07-05T12:05:00Z",
        "finished_at": "2026-07-05T12:06:00Z",
        "duration_ms": 60000,
        "payment_card": "",
        "attempt_current": 1,
        "attempt_max": 3,
        "retrying": false,
        "payment_result_checking": false
      }
    },
    {
      "cdk": "AUTO-SUB-BBBB2222",
      "code": 200,
      "error": "",
      "cdk_status": "unused",
      "order": null
    }
  ]
}

批量请求失败

当 cdks 为空、全部为空字符串、数量超过 50 个或存在重复 CDK 时，接口返回业务失败。

{
  "code": 0,
  "error": "存在重复 CDK：AUTO-SUB-AAAA1111"
}

兼容性说明

已接入 cdk 的调用方暂时不需要立刻修改，单个查询结构仍会返回。

新接入方和后续维护都应使用 cdks，即使只查一个 CDK，也建议传 cdks: ["..."]。

后续版本会取消 cdk 字段，请不要在新代码中继续依赖它。

空结果仍保持隐私保护：order=null 不代表 CDK 一定存在，且不会返回服务商和产品详情。

有订单时仍会返回 provider 和 payment_result_checking，调用方可继续用于展示服务商和支付结果确认状态。

调用建议

将用户输入拆分为 CDK 数组，去除首尾空白并过滤空字符串。

前端可先做重复检查；如果仍提交重复 CDK，接口会返回业务失败。

单次请求最多提交 50 个 CDK。

使用返回的 results 渲染列表，每条结果独立读取 code、error、cdk_status 和 order。

查询兑换提交后的实时进度，仍优先使用 redeemResult；queryOrder 更适合手动查询和售后查询。

v1.1.1 更新说明（2026-07-05）

v1.1.1 更新说明#

一句话概览#

变化级别#

接口变化#

请求参数#

批量响应#

批量请求失败#

兼容性说明#

调用建议#