주요 콘텐츠로 건너뛰기

API 참조

주문 API

주문 API

주문 API는 주문 생성(공개, 고객용)과 주문 관리(인증 필요, 레스토랑 운영자용)를 처리합니다. 레스토랑에서 Ordering Suite 애드온이 활성화되어 있어야 합니다.

POST /api/orders

새 주문을 만듭니다. 고객이 메뉴에서 주문할 때 사용하는 공개 엔드포인트입니다.

인증: 공개(토큰 불필요)

속도 제한: IP당 분당 5회 요청

요청 본문

{
  "restaurantId": "uuid",
  "tableId": "uuid",
  "items": [
    {
      "menuItemId": "uuid",
      "quantity": 2
    },
    {
      "menuItemId": "uuid",
      "quantity": 1
    }
  ]
}

응답(201 Created)

{
  "success": true,
  "data": {
    "id": "uuid",
    "status": "PENDING",
    "tableLabel": "Table 5",
    "items": [...],
    "createdAt": "2026-02-19T14:30:00Z"
  }
}

GET /api/orders

레스토랑의 모든 주문을 조회합니다. 상태별 필터링을 지원합니다.

인증: 필요(Bearer 토큰)

쿼리 매개변수

  • status — 주문 상태로 필터링합니다(예: ?status=PENDING)

응답(200 OK)

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "status": "PENDING",
      "tableLabel": "Table 5",
      "items": [...],
      "createdAt": "2026-02-19T14:30:00Z"
    }
  ]
}

GET /api/orders/[id]

단일 주문을 조회합니다. 이 엔드포인트는 두 가지 접근 모드를 지원합니다.

  • 인증됨(운영자): 모든 필드를 포함한 전체 주문 데이터를 반환합니다.
  • 공개(고객): 제한된 필드(상태, 항목, 테이블 라벨)를 반환합니다. restaurantId 쿼리 매개변수가 필요합니다.

PATCH /api/orders/[id]

주문 상태를 업데이트합니다. 레스토랑 운영자가 주문을 수명 주기에 따라 진행시킬 때 사용합니다.

인증: 필요(Bearer 토큰)

요청 본문

{
  "status": "CONFIRMED"
}

유효한 상태 전환: PENDING에서 CONFIRMED, CONFIRMED에서 PREPARING, PREPARING에서 READY, READY에서 SERVED. 주문은 PENDING 또는 CONFIRMED 상태에서 CANCELLED로 설정할 수 있습니다.