# 드롭쉬핑 주문 목록: 창고 + 기간, 또는 client_order_number / serial_number 로 한 건 찾기

`GET /api/v1/dropship-orders` — 토큰 필요 · df:read · 1포인트

드롭쉬핑 주문

## 쿼리 파라미터

| 이름 | 타입 | 설명 |
| --- | --- | --- |
| `warehouse_code` | string | 창고 코드: AU(호주 전체 — 합계 뷰), AUSYD2(시드니 메인, Rosehill), AUSYD1(시드니 액세서리), CN(중국 전체 — 합계 뷰), CHNZJ1(전장). 전체 목록: GET /api/v1/warehouses. |
| `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}$) |
| `shipped` | boolean | 출고됨(true) 또는 미출고(false) 만(선택). |
| `client_order_number` | string | 내 시스템의 주문번호(드롭쉬핑 주문 생성 시 보낸 값). (최대 길이 64) |
| `serial_number` | string | 드롭쉬핑 일련번호, 드롭쉬핑 주문 목록에서 확인. 본인 채널만. (최대 길이 64) |

## 응답

봉투는 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/dropship-orders?warehouse_code=AU&start_date=2026-09-01" \
  -H "Authorization: Bearer $TOKEN"
```

### Python

```python
import requests

r = requests.get(
    "https://connect.everugg.net.au/api/v1/dropship-orders?warehouse_code=AU&start_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/dropship-orders?warehouse_code=AU&start_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/dropship-orders?warehouse_code=AU&start_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-dropship-orders.md?lang=ko · 웹 페이지: https://connect.everugg.net.au/reference?op=get-api-v1-dropship-orders&lang=ko