# 按日期区间查本渠道批发订单；可再按 client_order_number 收窄

`GET /api/v1/orders` — 需要 token · order:read · 1 点

批发订单

## 查询参数

| 名称 | 类型 | 说明 |
| --- | --- | --- |
| `client_order_number` | string | 你自己那边的单号（下单时传过的）——对账时拿它找回我们这边的单 (最长 64) |
| `start_date` **必填** | string | 起始日期，格式 YYYY-MM-DD（含）。 (最长 10 · 格式 ^[0-9]{4}-[0-9]{2}-[0-9]{2}$) |
| `end_date` **必填** | string | 截止日期，格式 YYYY-MM-DD（含）。 (最长 10 · 格式 ^[0-9]{4}-[0-9]{2}-[0-9]{2}$) |
| `status` | string | 逗号分隔：draft / confirmed / cancelled (最长 128 · 格式 ^[A-Za-z0-9,\s_-]*$) |

## 响应

响应信封只看 HTTP 状态码：成功是 2xx，正文 `{ data: … }`（列表另带 `page / page_size / has_more` 或 `total_count`）；失败是 4xx / 5xx，正文 `{ error: { code, message, hint, request_id, doc_url } }`。

```json
{
  "data": [ … ],
  "total_count": 12
}
```

成功响应里没有任何给人看的文字——没有 `code / result / msg`。`error.code` 是唯一该用程序判断的字段，`message` 跟随 `Accept-Language`。

## 示例

### curl

```bash
curl "https://connect.everugg.net.au/api/v1/orders?start_date=2026-09-01&end_date=2026-09-01" \
  -H "Authorization: Bearer $TOKEN"
```

### Python

```python
import requests

r = requests.get(
    "https://connect.everugg.net.au/api/v1/orders?start_date=2026-09-01&end_date=2026-09-01",
    headers={"Authorization": "Bearer " + TOKEN},
)
data = r.json()
r.raise_for_status()  # 4xx/5xx: data["error"]["code"] / ["hint"]
```

### Node

```js
const res = await fetch("https://connect.everugg.net.au/api/v1/orders?start_date=2026-09-01&end_date=2026-09-01", {
  headers: { Authorization: `Bearer ${TOKEN}` },
})
const data = await res.json()
if (!res.ok) throw new Error(`${data.error?.code}: ${data.error?.message}`)
```

### Java

```java
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("https://connect.everugg.net.au/api/v1/orders?start_date=2026-09-01&end_date=2026-09-01"))
    .header("Authorization", "Bearer " + token)
    .GET()
    .build();
HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
```

---
Markdown 源: https://connect.everugg.net.au/reference/get-api-v1-orders.md?lang=zh · 网页版: https://connect.everugg.net.au/reference?op=get-api-v1-orders&lang=zh