주요 콘텐츠로 건너뛰기

API 참조

메뉴 항목 API

메뉴 항목 API

메뉴 항목 API를 사용하면 레스토랑의 메뉴 항목을 생성, 조회, 업데이트, 삭제할 수 있습니다. 모든 엔드포인트는 인증이 필요하며 인증된 사용자의 레스토랑에 속한 항목을 대상으로 동작합니다.

GET /api/menu-items

레스토랑의 모든 메뉴 항목을 조회합니다.

인증: 필요(Bearer 토큰)

응답(200 OK)

{
  "success": true,
  "data": [
    {
      "id": "uuid",
      "name": "Margherita Pizza",
      "description": "Classic pizza with fresh mozzarella and basil",
      "price": 14.99,
      "priceCents": 1499,
      "category": "Mains",
      "photoUrl": "https://...",
      "isActive": true,
      "position": 1,
      "createdAt": "2026-02-01T12:00:00Z",
      "updatedAt": "2026-02-01T12:00:00Z"
    }
  ]
}

POST /api/menu-items

새 메뉴 항목을 만듭니다. 사진은 업로드 엔드포인트를 통해 별도로 업로드한 다음 URL로 참조해야 합니다.

인증: 필요(Bearer 토큰)

요청 본문

{
  "name": "Chicken Tikka Masala",
  "description": "Tender chicken in a rich, creamy tomato sauce",
  "price": 16.99,
  "category": "Mains",
  "photoUrl": "https://..."
}

응답(201 Created)

{
  "success": true,
  "data": {
    "id": "uuid",
    "name": "Chicken Tikka Masala",
    ...
  }
}

PATCH /api/menu-items/[id]

기존 메뉴 항목을 업데이트합니다. 변경하려는 필드만 포함하세요.

인증: 필요(Bearer 토큰)

요청 본문

{
  "price": 17.99,
  "description": "Updated description"
}

응답(200 OK)

{
  "success": true,
  "data": {
    "id": "uuid",
    "price": 17.99,
    ...
  }
}

DELETE /api/menu-items/[id]

메뉴 항목과 연결된 사진 및 3D 모델을 영구적으로 삭제합니다.

인증: 필요(Bearer 토큰)

응답(200 OK)

{
  "success": true,
  "data": { "deleted": true }
}