구매자 주문 API

내 주문 목록·상세 조회 API입니다. 조회 전용입니다.

엔드포인트

구분설명

GET /orders

주문 목록 (orders:read)

GET /orders/{order_number}

주문 상세 (orders:read)

목록 조회

쿼리: status, payment_status, page, limit(1~100, 기본 20)

식별자는 order_number입니다. UUID 경로·응답은 지원하지 않습니다.

bash

curl "https://qnector.kr/api/v1/buyer/orders?status=confirmed&page=1&limit=20" \
  -H "Authorization: Bearer qnc_buyer_YOUR_API_KEY"

엔드포인트 예시

GET /orders

주문 목록 (orders:read)

응답 예시 (200)

json

{
  "data": [
    {
      "order_number": "ORD-20260626-001",
      "status": "confirmed",
      "payment_status": "DONE",
      "total_amount": 45000,
      "created_at": "2026-06-26T10:00:00Z",
      "tracking_number": null,
      "delivery_company": null,
      "delivery_memo": null,
      "items": [
        {
          "prod_code": "SKU-001",
          "prod_name": "사과 5kg",
          "quantity": 3,
          "price_per_unit": 15000,
          "seller_code": "123-45-67890"
        }
      ]
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1 },
  "errors": []
}

상세 조회

경로의 order_number로 단일 주문을 조회합니다. UUID를 넣으면 404입니다.