Skip to main content
GET
Batch order lookup
使用此端点可在一次调用中轮询多个订单的状态。以逗号分隔的列表形式提供 custom_ids(您在下单时分配的 id)和/或 order_ids(CSBoard 订单 id)。两者至少需提供一个,且两者总和不得超过 200 个 id。 需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。

查询参数

string
以逗号分隔的、您在下单时分配的自定义 id。
string
以逗号分隔的 CSBoard 订单 id。
custom_idsorder_ids 至少需提供一个。两个参数中 id 的总数不得超过 200。

响应字段

Order[]
必填
匹配的订单数组。每个 Order 的结构与 GET /v1/orders 中相同——包括 order_idstatuscharged_total_usd 以及逐件 items 明细。

示例请求

示例响应

错误代码

授权

Authorization
string
header
必填

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

查询参数

custom_ids
string

Comma-separated custom ids you assigned at purchase time.

order_ids
string

Comma-separated CSBoard order ids.

响应

Matching orders.

data
object[]
必填