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

查询参数

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

响应字段

Order[]
必填
匹配的订单数组。每个 Order 的结构与 GET /v1/orders 中相同——包括 order_id、status、charged_total_usd、delivery_type、delivery_deadline_at、fail_reason、fail_side、fail_message 以及逐件 items 明细。原因代码列表见 订单失败的原因。

示例请求

示例响应

错误代码

授权

Authorization
string
header
必填

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile. Calls made with a key are metered only by that key's own limits — there is no per-IP limit on top — and every answer carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and X-RateLimit-Bucket for the bucket the call spent. See Rate limits.

查询参数

custom_ids
string

Comma-separated custom ids you assigned at purchase time.

order_ids
string

Comma-separated CSBoard order ids.

响应

Matching orders.

data
object[]
必填