{"info":{"_postman_id":"63d0c8c9-b3ab-4d16-8d55-75ca79a223e3","name":"더존 빵돌이 공식 API 문서 | 개발자 가이드","description":"<html><head></head><body><img src=\"https://content.pstmn.io/6e4a8551-d258-46bb-8da0-3cb036ef650a/YnJlYWRrdW5Mb2dvRGFya01vZGUucG5n\" width=\"512\" height=\"205\">\n\n<h2 id=\"1-개요\">1. 개요</h2>\n<p>더존 빵돌이 API는 <strong>일반 사용자</strong>와 <strong>관리자</strong>를 대상으로 하는 <strong>RESTful API</strong>로, 더존 빵돌이 관련 데이터를 효율적으로 관리하고 활용할 수 있도록 설계되었습니다. API는 사용 목적과 대상 사용자에 따라 두 가지로 구분됩니다.</p>\n<h3 id=\"공용-api-common-api\">공용 API (Common API)</h3>\n<ul>\n<li><strong>대상 사용자</strong>: 일반 사용자 및 관리자</li>\n</ul>\n<h4 id=\"주요-기능\">주요 기능</h4>\n<ul>\n<li><p><strong>데이터 조회</strong>: 서비스 이용을 위한 정보 제공 (예: 카페 메뉴 조회, 식단 확인, 통근 버스 확인 등)</p>\n</li>\n<li><p><strong>사용자 요청 처리</strong>: 카페 메뉴 추가 등</p>\n</li>\n<li><p><strong>엔드포인트 시작점</strong>: /api</p>\n</li>\n</ul>\n<h3 id=\"관리자-전용-api-admin-api\">관리자 전용 API (Admin API)</h3>\n<ul>\n<li><strong>대상 사용자</strong>: 관리자</li>\n</ul>\n<h4 id=\"주요-기능-1\">주요 기능</h4>\n<ul>\n<li><p><strong>데이터 관리</strong>: 서비스 데이터의 추가, 수정, 삭제</p>\n</li>\n<li><p><strong>통계 및 리포트 확인</strong>: 서비스 운영을 위한 통계 자료 제공</p>\n</li>\n<li><p><strong>설정 관리</strong>: 서비스 설정 및 구성 변경</p>\n</li>\n<li><p><strong>엔드포인트 시작점</strong>: /api/admin</p>\n</li>\n</ul>\n<h2 id=\"2-사용-가이드\">2. 사용 가이드</h2>\n<h3 id=\"http-메서드\">HTTP 메서드</h3>\n<ul>\n<li>표준 HTTP 메서드 <strong>GET</strong>, <strong>POST</strong>, <strong>PUT</strong>, <strong>DELETE</strong> 사용</li>\n</ul>\n<h4 id=\"특이-사항\">특이 사항</h4>\n<ul>\n<li><p><strong>다중 삭제</strong> 작업은 <strong>POST</strong> 메서드를 사용하며,</p>\n</li>\n<li><p>URI에 /delete 명시</p>\n</li>\n</ul>\n<h3 id=\"데이터-형식\">데이터 형식</h3>\n<ul>\n<li>모든 요청 및 응답 데이터는 <strong>JSON 형식</strong></li>\n</ul>\n<h2 id=\"3-오류-처리\">3. 오류 처리</h2>\n<ul>\n<li>API 사용 중 요청이 실패하면, 아래와 같은 일관된 JSON 형식의 오류 응답을 반환</li>\n</ul>\n<h3 id=\"오류-응답-형식\">오류 응답 형식</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"CA-2002\",\n    \"message\": \"CafeCart must be ACTIVE\"\n  }\n}\n\n</code></pre>\n<ul>\n<li><p><code>success</code>: 요청 처리 성공 여부 (오류 시 항상 <code>false</code>)</p>\n</li>\n<li><p><code>error.code</code>: 오류 상황 식별을 위한 코드</p>\n</li>\n<li><p><code>error.message</code>: 클라이언트에게 전달되는 오류 설명 메시지</p>\n</li>\n</ul>\n<h3 id=\"오류-코드\">오류 코드</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>코드</th>\n<th>HTTP 상태 코드</th>\n<th>오류 설명</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>VAL-0001</td>\n<td>400</td>\n<td>헤더 입력값 누락 또는 유효하지 않은 입력값입니다.</td>\n</tr>\n<tr>\n<td>VAL-0002</td>\n<td>400</td>\n<td>필드 입력값 누락 또는 유효하지 않은 입력값입니다.</td>\n</tr>\n<tr>\n<td>VAL-0003</td>\n<td>400</td>\n<td>필드 입력값 누락 또는 유효하지 않은 입력값입니다.</td>\n</tr>\n<tr>\n<td>CA-1001</td>\n<td>404</td>\n<td>CafeMenu가 존재하지 않습니다.</td>\n</tr>\n<tr>\n<td>CA-2001</td>\n<td>404</td>\n<td>CafeCart가 존재하지 않습니다.</td>\n</tr>\n<tr>\n<td>CA-2002</td>\n<td>422</td>\n<td>CafeCart가 활성 상태가 아니므로 요청을 처리할 수 없습니다.</td>\n</tr>\n<tr>\n<td>CA-2003</td>\n<td>409</td>\n<td>CafeCart와 CafeCartItem의 카페 위치가 달라 처리할 수 없습니다.</td>\n</tr>\n<tr>\n<td>CA-2004</td>\n<td>403</td>\n<td>CafeCart 생성자와 일치하지 않습니다.</td>\n</tr>\n<tr>\n<td>CA-3001</td>\n<td>404</td>\n<td>CafeCartItem이 존재하지 않습니다.</td>\n</tr>\n<tr>\n<td>CA-3002</td>\n<td>403</td>\n<td>CafeCartItem 생성자와 일치하지 않습니다.</td>\n</tr>\n<tr>\n<td>SSE-1001</td>\n<td>500</td>\n<td>SSE 이벤트 전송 중 서버 내부 오류가 발생했습니다.</td>\n</tr>\n<tr>\n<td>SSE-1002</td>\n<td>403</td>\n<td>클라이언트가 SSE 구독이 거부되었습니다.</td>\n</tr>\n<tr>\n<td>SSE-1003</td>\n<td>408</td>\n<td>장시간 유휴 상태로 인해 SSE 연결이 종료되었습니다.</td>\n</tr>\n<tr>\n<td>E-400</td>\n<td>400</td>\n<td>잘못된 요청입니다. (IllegalArgumentException 또는 BindException 발생 시)</td>\n</tr>\n<tr>\n<td>E-500</td>\n<td>500</td>\n<td>서버 내부에서 알 수 없는 오류가 발생했습니다.</td>\n</tr>\n</tbody>\n</table>\n</div><p>모든 오류 응답은 이 표에 정의된 규칙을 따름</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"31818010","collectionId":"63d0c8c9-b3ab-4d16-8d55-75ca79a223e3","publishedId":"2sAY546yf4","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-11-21T09:00:57.000Z"},"item":[{"name":"Common API","item":[{"name":"Cafe","item":[{"name":"Menu","item":[{"name":"카페 메뉴판 조회","id":"f4c25641-397c-4a2d-addd-4fb7d6c63936","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true}},"request":{"method":"GET","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"}],"url":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/menus/board","description":"<ul>\n<li>유효한 메뉴(available = true)만 리턴</li>\n</ul>\n","urlObject":{"protocol":"http","path":["api","cafe","menus","board"],"host":["{{BREADKUN_API_BASE_URL}}"],"query":[{"disabled":true,"description":{"content":"<p>(String) 카페위치; Available values : KANGCHON, EULJI</p>\n","type":"text/plain"},"key":"cafeLocation","value":""},{"disabled":true,"description":{"content":"<p>(String) 메뉴명; Like query</p>\n","type":"text/plain"},"key":"name","value":""},{"disabled":true,"description":{"content":"<p>(String) 카테고리; Available values : COFFEE, TEA, DRINK, SEASON</p>\n","type":"text/plain"},"key":"category","value":""},{"disabled":true,"description":{"content":"<p>(Int) 사이즈</p>\n","type":"text/plain"},"key":"size","value":""},{"disabled":true,"description":{"content":"<p>(Int) 페이지; 0-based indexing</p>\n","type":"text/plain"},"key":"page","value":""}],"variable":[]}},"response":[{"id":"2acc8c73-50d0-4c2c-ac2e-d223d051b949","name":"카페 메뉴판 페이징 조회","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"}],"url":{"raw":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/menus/board?cafeLocation=KANGCHON&name=차&category=TEA&size=5&page=0","protocol":"http","host":["{{BREADKUN_API_BASE_URL}}"],"path":["api","cafe","menus","board"],"query":[{"key":"cafeLocation","value":"KANGCHON","description":"(String) 위치; Available values : KANGCHON, EULJI"},{"key":"name","value":"차","description":"(String) 메뉴명; Like query"},{"key":"category","value":"TEA","description":"(String) 카테고리; Available values : COFFEE, TEA, DRINK, SEASON"},{"key":"size","value":"5","description":"(Int) 사이즈"},{"key":"page","value":"0","description":"(Int) 페이지; 0-based indexing"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"1482"}],"cookie":[],"responseTime":null,"body":"{\n    \"success\": true, // 요청 성공 여부\n    \"meta\": { // 리턴 메타 데이터\n        \"totalItems\": 3, // data 전체 개수\n        \"totalPages\": 1, // 전체 페이지 개수\n        \"pageSize\": 5, // 페이지 크기\n        \"currentPage\": 0, // 현제 페이지\n        \"timestamp\": \"2024-12-09T09:47:01.161553117\" // 리턴 시각\n    },\n    \"data\": { // 리턴 데이터\n        \"cafeMenuBoard\": [ // 카페 메뉴판\n            {\n                \"cafeLocation\": \"KANGCHON\", // 카페 위치\n                \"name\": \"레몬 생강차\", // 음료 이름\n                \"category\": \"TEA\", // 음료 카테고리\n                \"options\": [ // 음료 옵션\n                    {\n                        \"drinkTemperature\": \"HOT\", // 음료 온도 HOT/ICED\n                        \"id\": 40, // 음료 ID\n                        \"available\": true, // 사용 가능 여부\n                        \"price\": 1000, // 음료 가격\n                        \"deposit\": 3000, // 리유저블 컵 보증금\n                        \"description\": null, // 음료 설명\n                        \"imageFilename\": \"sample.webp\", // 음료 사진 파일명\n                        \"imageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f39f\" // 음료 사진 URL\n                    }\n                ]\n            },\n            {\n                \"cafeLocation\": \"KANGCHON\",\n                \"name\": \"보이차\",\n                \"category\": \"TEA\",\n                \"options\": [\n                    {\n                        \"drinkTemperature\": \"HOT\",\n                        \"id\": 44,\n                        \"available\": true,\n                        \"price\": 1000,\n                        \"deposit\": 3000,\n                        \"description\": null,\n                        \"imageFilename\": \"sample.webp\",\n                        \"imageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f55f\"\n                    },\n                    {\n                        \"drinkTemperature\": \"ICED\",\n                        \"id\": 45,\n                        \"available\": true,\n                        \"price\": 1000,\n                        \"deposit\": 3000,\n                        \"description\": null,\n                        \"imageFilename\": \"sample.webp\",\n                        \"imageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f09f\"\n                    }\n                ]\n            },\n            {\n                \"cafeLocation\": \"KANGCHON\",\n                \"name\": \"유자차\",\n                \"category\": \"TEA\",\n                \"options\": [\n                    {\n                        \"drinkTemperature\": \"HOT\",\n                        \"id\": 46,\n                        \"available\": true,\n                        \"price\": 1000,\n                        \"deposit\": 3000,\n                        \"description\": null,\n                        \"imageFilename\": \"sample.webp\",\n                        \"imageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f08f\"\n                    },\n                    {\n                        \"drinkTemperature\": \"ICED\",\n                        \"id\": 47,\n                        \"available\": true,\n                        \"price\": 1000,\n                        \"deposit\": 3000,\n                        \"description\": null,\n                        \"imageFilename\": \"sample.webp\",\n                        \"imageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f13f\"\n                    }\n                ]\n            }\n        ]\n    }\n}"},{"id":"f843ab0e-1b3d-4602-b679-6e84737f653f","name":"카페 메뉴판 조회","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"}],"url":{"raw":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/menus/board?cafeLocation=KANGCHON&name=아메&category=COFFEE","protocol":"http","host":["{{BREADKUN_API_BASE_URL}}"],"path":["api","cafe","menus","board"],"query":[{"key":"cafeLocation","value":"KANGCHON","description":"(String) 위치; Available values : KANGCHON, EULJI"},{"key":"name","value":"아메","description":"(String) 메뉴명; Like query"},{"key":"category","value":"COFFEE","description":"(String) 카테고리; Available values : COFFEE, TEA, DRINK, SEASON"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"1704"}],"cookie":[],"responseTime":null,"body":"{\n    \"success\": true, // 요청 성공 여부\n    \"meta\": { // 리턴 메타 데이터\n        \"totalItems\": 3, // data 전체 개수\n        \"timestamp\": \"2024-12-09T09:48:52.054731007\" // 리턴 시각\n    },\n    \"data\": { // 리턴 데이터\n        \"cafeMenuBoard\": [ // 카페 메뉴판\n            {\n                \"cafeLocation\": \"KANGCHON\", // 카페 위치\n                \"name\": \"아메리카노 스모키\", // 음료 이름\n                \"category\": \"COFFEE\", // 음료 카테고리\n                \"options\": [ // 음료 옵션\n                    {\n                        \"drinkTemperature\": \"HOT\", // 음료 온도 HOT/ICED\n                        \"id\": 7, // 음료 ID\n                        \"available\": true, // 사용 가능 여부\n                        \"price\": 1000, // 음료 가격\n                        \"deposit\": 3000, // 리유저블 컵 보증금\n                        \"description\": null, // 음료 설명\n                        \"imageFilename\": \"sample.webp\", // 음료 사진 파일명\n                        \"imageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f17f\" // 음료 사진 URL\n                    },\n                    {\n                        \"drinkTemperature\": \"ICED\",\n                        \"id\": 8,\n                        \"available\": true,\n                        \"price\": 1000,\n                        \"deposit\": 3000,\n                        \"description\": null,\n                        \"imageFilename\": \"sample.webp\",\n                        \"imageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f28f\"\n                    }\n                ]\n            },\n            {\n                \"cafeLocation\": \"KANGCHON\",\n                \"name\": \"아메리카노 정글\",\n                \"category\": \"COFFEE\",\n                \"options\": [\n                    {\n                        \"drinkTemperature\": \"HOT\",\n                        \"id\": 9,\n                        \"available\": true,\n                        \"price\": 1000,\n                        \"deposit\": 3000,\n                        \"description\": null,\n                        \"imageFilename\": \"sample.webp\",\n                        \"imageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f18f\"\n                    },\n                    {\n                        \"drinkTemperature\": \"ICED\",\n                        \"id\": 10,\n                        \"available\": true,\n                        \"price\": 1000,\n                        \"deposit\": 3000,\n                        \"description\": null,\n                        \"imageFilename\": \"sample.webp\",\n                        \"imageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f29f\"\n                    }\n                ]\n            },\n            {\n                \"cafeLocation\": \"KANGCHON\",\n                \"name\": \"헤이즐넛 아메리카노\",\n                \"category\": \"COFFEE\",\n                \"options\": [\n                    {\n                        \"drinkTemperature\": \"HOT\",\n                        \"id\": 25,\n                        \"available\": true,\n                        \"price\": 1000,\n                        \"deposit\": 3000,\n                        \"description\": null,\n                        \"imageFilename\": \"sample.webp\",\n                        \"imageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f19f\"\n                    },\n                    {\n                        \"drinkTemperature\": \"ICED\",\n                        \"id\": 26,\n                        \"available\": true,\n                        \"price\": 1000,\n                        \"deposit\": 3000,\n                        \"description\": null,\n                        \"imageFilename\": \"sample.webp\",\n                        \"imageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f30f\"\n                    }\n                ]\n            }\n        ]\n    }\n}"}],"_postman_id":"f4c25641-397c-4a2d-addd-4fb7d6c63936"}],"id":"b76754ef-c89c-4440-96fb-cef98699f702","_postman_id":"b76754ef-c89c-4440-96fb-cef98699f702","description":""},{"name":"Cart","item":[{"name":"카페 장바구니 단건 조회","id":"323558da-b158-4333-8813-1784de3cc546","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true}},"request":{"method":"GET","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"},{"key":"X-SSR-Token","value":"","description":"<p>(String) SSR토큰</p>\n","type":"text"}],"url":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts/:cafeCartId","urlObject":{"protocol":"http","path":["api","cafe","carts",":cafeCartId"],"host":["{{BREADKUN_API_BASE_URL}}"],"query":[],"variable":[{"description":{"content":"<p>[required] (String) 카페장바구니ID</p>\n","type":"text/plain"},"type":"any","value":"","key":"cafeCartId"}]}},"response":[{"id":"523f4b72-dc27-4b18-8fea-74b922942834","name":"카페 장바구니 단건 조회(토큰O)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"},{"key":"X-SSR-Token","value":"test/token","description":"(String) SSR토큰","type":"text"}],"url":{"raw":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts/:cafeCartId","protocol":"http","host":["{{BREADKUN_API_BASE_URL}}"],"path":["api","cafe","carts",":cafeCartId"],"variable":[{"key":"cafeCartId","value":"01JQXT9T4P93TJEY6P2TP331D9","description":"[required] (String) 카페장바구니ID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"466"}],"cookie":[],"responseTime":null,"body":"{\n    \"success\": true,\n    \"meta\": {\n        \"totalItems\": 1,\n        \"timestamp\": \"2025-04-03T22:06:02.479581\"\n    },\n    \"data\": {\n        \"cafeCart\": {\n            \"id\": \"01JQXT9T4P93TJEY6P2TP331D9\",\n            \"cafeLocation\": \"KANGCHON\",\n            \"title\": \"장바구니 이름입니다.\",\n            \"description\": \"장바구니 설명입니다.\",\n            \"createdAt\": \"2025-04-03T21:34:03.361275\",\n            \"expiresAt\": \"2025-04-03T23:34:03.361275\",\n            \"secureShareKey\": \"zzF2J0XP26y5GM1Pk0ccWQZB02rGIFD63dV/UmR9c4I=\", // secureShareKey 공개\n            \"createdById\": \"aac77b3b-d818-48d8-a8e5-0adf7c42fa3c\",\n            \"status\": \"ACTIVE\"\n        }\n    }\n}"},{"id":"9393c401-4c99-420f-959a-a588dbfba09e","name":"카페 장바구니 단건 조회(토큰X)","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"}],"url":{"raw":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts/:cafeCartId","protocol":"http","host":["{{BREADKUN_API_BASE_URL}}"],"path":["api","cafe","carts",":cafeCartId"],"variable":[{"key":"cafeCartId","value":"01JEMKCKNK00W2QR6X8VD5BTK6","description":"[required] (String) 카페장바구니ID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"405"}],"cookie":[],"responseTime":null,"body":"{\n    \"success\": true, // 요청 성공 여부\n    \"meta\": { // 리턴 메타 데이터\n        \"totalItems\": 1, // data 전체 개수\n        \"timestamp\": \"2024-12-09T11:20:03.936782161\" // 리턴 시각\n    },\n    \"data\": { // 리턴 데이터\n        \"cafeCart\": { // 카트 장바구니\n            \"id\": \"01JEMKCKNK00W2QR6X8VD5BTK6\", // 장바구니 ID\n            \"cafeLocation\": \"KANGCHON\", // 카페 위치\n            \"title\": \"장바구니 이름입니다.\", // 장바구니 이름\n            \"description\": \"장바구니 설명입니다.\", // 장바구니 설명\n            \"createdAt\": \"2024-12-09T11:18:48.879086\", // 생성일\n            \"expiresAt\": \"2024-12-09T14:18:48.879086\", // 장바구니 만료일(3시간)\n            \"secureShareKey\": null, // secureShareKey 비공개\n            \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\", // 생성자 UUID\n            \"status\": \"ACTIVE\" // 장바구니 활성 상태 ACTIVE/INACTIVE\n        }\n    }\n}"}],"_postman_id":"323558da-b158-4333-8813-1784de3cc546"},{"name":"카페 장바구니 생성","id":"7e328f71-9f3e-4b2d-9ac0-e7b33aeb9615","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true}},"request":{"method":"POST","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"},{"key":"X-User-UUID","value":"","description":"<p>[required] (String) 사용자ID</p>\n","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts","description":"<ul>\n<li><p>장바구니는 생성 즉시 ACTIVE 상태이며,</p>\n</li>\n<li><p>3시간 동안 유효함</p>\n</li>\n</ul>\n<h4 id=\"body\">BODY</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Key</strong></th>\n<th><strong>Description</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>cafeLocation</td>\n<td>[required] (String) 카페 위치; Available values : KANGCHON, EULJI</td>\n</tr>\n<tr>\n<td>title</td>\n<td>[required] (String) 장바구니 이름</td>\n</tr>\n<tr>\n<td>description</td>\n<td>(String) 장바구니 설명</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"http","path":["api","cafe","carts"],"host":["{{BREADKUN_API_BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"e620e26d-2959-4782-89ad-d2d62ea44056","name":"카페 장바구니 생성","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"},{"key":"X-User-UUID","value":"aac77b3b-d818-48d8-a8e5-0adf7c42fa3c","description":"[required] (String) 사용자ID","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"cafeLocation\": \"KANGCHON\",\n    \"title\": \"장바구니 이름입니다.\",\n    \"description\": \"장바구니 설명입니다.\"\n}","options":{"raw":{"language":"json"}}},"url":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"466"}],"cookie":[],"responseTime":null,"body":"{\n    \"success\": true,\n    \"meta\": {\n        \"totalItems\": 1,\n        \"timestamp\": \"2025-03-27T23:00:02.070382\"\n    },\n    \"data\": {\n        \"cafeCart\": {\n            \"id\": \"01JQBYE6R832AMAYZGMSKM6JZV\",\n            \"cafeLocation\": \"KANGCHON\",\n            \"title\": \"장바구니 이름입니다.\",\n            \"description\": \"장바구니 설명입니다.\",\n            \"createdAt\": \"2025-03-27T23:00:02.041018\",\n            \"expiresAt\": \"2025-03-28T02:00:02.041018\",\n            \"secureShareKey\": null, // secureShareKey 비공개\n            \"createdById\": \"aac77b3b-d818-48d8-a8e5-0adf7c42fa3c\",\n            \"status\": \"ACTIVE\"\n        }\n    }\n}"}],"_postman_id":"7e328f71-9f3e-4b2d-9ac0-e7b33aeb9615"},{"name":"카페 장바구니 \b만료 처리","id":"c21995bf-56e3-448a-91b2-2aaf00c52fb1","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true}},"request":{"method":"PATCH","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"},{"key":"X-User-UUID","value":"","description":"<p>[required] (String) 사용자ID</p>\n","type":"text"}],"url":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts/:cafeCartId/expire","description":"<ul>\n<li><p>ACTIVE 상태인 장바구니를 즉시 종료(INACTIVE) 처리</p>\n</li>\n<li><p>장바구니 소유자(생성자)만 가능</p>\n</li>\n</ul>\n","urlObject":{"protocol":"http","path":["api","cafe","carts",":cafeCartId","expire"],"host":["{{BREADKUN_API_BASE_URL}}"],"query":[],"variable":[{"description":{"content":"<p>[required] (String) 카페장바구니ID</p>\n","type":"text/plain"},"type":"any","value":"","key":"cafeCartId"}]}},"response":[{"id":"295230dc-b5ce-4a95-abb4-1022a9745159","name":"카페 장바구니 \b만료 처리","originalRequest":{"method":"PATCH","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"},{"key":"X-User-UUID","value":"aac77b3b-d818-48d8-a8e5-0adf7c42fa3c","description":"[required] (String) 사용자ID","type":"text"}],"url":{"raw":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts/:cafeCartId/expire","protocol":"http","host":["{{BREADKUN_API_BASE_URL}}"],"path":["api","cafe","carts",":cafeCartId","expire"],"variable":[{"key":"cafeCartId","value":"01JR85DBA3DS4FCG5DAR0W201S","description":"[required] (String) 카페장바구니ID"}]}},"status":"No Content","code":204,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"c21995bf-56e3-448a-91b2-2aaf00c52fb1"},{"name":"카페 장바구니 항목 다건 조회","id":"61f60be4-b613-4319-a547-1b17dcc9ab69","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true}},"request":{"method":"GET","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"}],"url":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts/:cafeCartId/items","description":"<ul>\n<li>include에 DETAILS을 전달하면, 상세 정보 포함</li>\n</ul>\n","urlObject":{"protocol":"http","path":["api","cafe","carts",":cafeCartId","items"],"host":["{{BREADKUN_API_BASE_URL}}"],"query":[{"disabled":true,"description":{"content":"<p>(String) 상세 정보 포함; Available values : DETAILS</p>\n","type":"text/plain"},"key":"include","value":""}],"variable":[{"description":{"content":"<p>[required] (String) 카페장바구니ID</p>\n","type":"text/plain"},"type":"any","value":"","key":"cafeCartId"}]}},"response":[{"id":"ed8479b6-6ec6-4526-a597-aa8d01120f93","name":"카페 장바구니 항목 다건 상세 조회","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"}],"url":{"raw":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts/:cafeCartId/items?include=DETAILS","protocol":"http","host":["{{BREADKUN_API_BASE_URL}}"],"path":["api","cafe","carts",":cafeCartId","items"],"query":[{"key":"include","value":"DETAILS","description":"(String) 상세 정보 포함; Available values : DETAILS"}],"variable":[{"key":"cafeCartId","value":"01JNNTNTAS3Z4ERAXK05KF2W00","description":"[required] (String) 카페장바구니ID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"3175"}],"cookie":[],"responseTime":null,"body":"{\n    \"success\": true, // 요청 성공 여부\n    \"meta\": { // 리턴 메타 데이터\n        \"totalItems\": 6, // data 전체 개수\n        \"timestamp\": \"2025-03-06T22:44:27.456657\" // 리턴 시각\n    },\n    \"data\": { // 리턴 데이터\n        \"cafeCartItem\": [ // 장바구니 항목\n            {\n                \"id\": \"01JNNTWTA77H06CKEP6R6Q15ZS\", // 장바구니 항목 ID\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\", // 장바구니 ID\n                \"cafeMenuId\": 45, // 음료 ID\n                \"isPersonalCup\": true, // 개인컵 사용 여부\n                \"quantity\": 2, // 주문 수량\n                \"imageUrl\": \"testUrl\", // 장바구니 항목 사진 URL\n                \"createdAt\": \"2025-03-06T22:39:07.121733\", // 주문 시각\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\", // 주문자 UUID\n                \"createdByName\": \"hong\", // 주문자 이름\n                \"drinkName\": \"보이차\", // 음료 이름\n                \"drinkPrice\": 1000, // 음료 가격\n                \"drinkTotalPrice\": 2000, // 총 음료 가격\n                \"drinkCategory\": \"TEA\", // 음료 카테고리\n                \"drinkTemperature\": \"ICED\", // 음료 온도 HOT/ICED\n                \"drinkImageFilename\": \"sample.webp\", // 음료 사진 파일명\n                \"drinkImageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f09f\" // 음료 사진 URL\n            },\n            {\n                \"id\": \"01JNNTWTB8FWV6EFSG36GMBFH3\",\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\",\n                \"cafeMenuId\": 50,\n                \"isPersonalCup\": false,\n                \"quantity\": 3,\n                \"imageUrl\": \"testUrl\",\n                \"createdAt\": \"2025-03-06T22:39:07.177483\",\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n                \"createdByName\": \"hong\",\n                \"drinkName\": \"페퍼민트\",\n                \"drinkPrice\": 4000,\n                \"drinkTotalPrice\": 12000,\n                \"drinkCategory\": \"TEA\",\n                \"drinkTemperature\": \"HOT\",\n                \"drinkImageFilename\": \"sample.webp\",\n                \"drinkImageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f07f\"\n            },\n            {\n                \"id\": \"01JNNTWTBZ9F04VDZT400H0AGF\",\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\",\n                \"cafeMenuId\": 39,\n                \"isPersonalCup\": true,\n                \"quantity\": 1,\n                \"imageUrl\": \"testUrl\",\n                \"createdAt\": \"2025-03-06T22:39:07.203078\",\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n                \"createdByName\": \"hong\",\n                \"drinkName\": \"홍차 라떼\",\n                \"drinkPrice\": 1000,\n                \"drinkTotalPrice\": 1000,\n                \"drinkCategory\": \"DRINK\",\n                \"drinkTemperature\": \"ICED\",\n                \"drinkImageFilename\": \"sample.webp\",\n                \"drinkImageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f44f\"\n            },\n            {\n                \"id\": \"01JNNV69PW7V1T725RXSFSR6MF\",\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\",\n                \"cafeMenuId\": 45,\n                \"isPersonalCup\": true,\n                \"quantity\": 2,\n                \"imageUrl\": \"testUrl\",\n                \"createdAt\": \"2025-03-06T22:44:17.818121\",\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n                \"createdByName\": \"hong\",\n                \"drinkName\": \"보이차\",\n                \"drinkPrice\": 1000,\n                \"drinkTotalPrice\": 2000,\n                \"drinkCategory\": \"TEA\",\n                \"drinkTemperature\": \"ICED\",\n                \"drinkImageFilename\": \"sample.webp\",\n                \"drinkImageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f09f\"\n            },\n            {\n                \"id\": \"01JNNV69QX9GKSYDSBKE6DJKRC\",\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\",\n                \"cafeMenuId\": 50,\n                \"isPersonalCup\": false,\n                \"quantity\": 3,\n                \"imageUrl\": \"testUrl\",\n                \"createdAt\": \"2025-03-06T22:44:17.844156\",\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n                \"createdByName\": \"hong\",\n                \"drinkName\": \"페퍼민트\",\n                \"drinkPrice\": 4000,\n                \"drinkTotalPrice\": 12000,\n                \"drinkCategory\": \"TEA\",\n                \"drinkTemperature\": \"HOT\",\n                \"drinkImageFilename\": \"sample.webp\",\n                \"drinkImageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f07f\"\n            },\n            {\n                \"id\": \"01JNNV69RWA0V0C135R8WKCCCY\",\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\",\n                \"cafeMenuId\": 39,\n                \"isPersonalCup\": true,\n                \"quantity\": 1,\n                \"imageUrl\": \"testUrl\",\n                \"createdAt\": \"2025-03-06T22:44:17.881263\",\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n                \"createdByName\": \"hong\",\n                \"drinkName\": \"홍차 라떼\",\n                \"drinkPrice\": 1000,\n                \"drinkTotalPrice\": 1000,\n                \"drinkCategory\": \"DRINK\",\n                \"drinkTemperature\": \"ICED\",\n                \"drinkImageFilename\": \"sample.webp\",\n                \"drinkImageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f44f\"\n            }\n        ]\n    }\n}"},{"id":"afd58533-729b-43ac-b1a9-3e654df3d2c7","name":"카페 장바구니 항목 다건 조회","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"}],"url":{"raw":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts/:cafeCartId/items","protocol":"http","host":["{{BREADKUN_API_BASE_URL}}"],"path":["api","cafe","carts",":cafeCartId","items"],"variable":[{"key":"cafeCartId","value":"01JNNTNTAS3Z4ERAXK05KF2W00","description":"[required] (String) 카페장바구니ID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"1705"}],"cookie":[],"responseTime":null,"body":"{\n    \"success\": true, // 요청 성공 여부\n    \"meta\": { // 리턴 메타 데이터\n        \"totalItems\": 6, // data 전체 개수\n        \"timestamp\": \"2025-03-06T22:44:41.538666\" // 리턴 시각\n    },\n    \"data\": { // 리턴 데이터\n        \"cafeCartItem\": [ // 장바구니 항목\n            {\n                \"id\": \"01JNNTWTA77H06CKEP6R6Q15ZS\", // 장바구니 항목 ID\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\", // 장바구니 ID\n                \"cafeMenuId\": 45, // 음료 ID\n                \"isPersonalCup\": true, // 개인컵 사용 여부\n                \"quantity\": 2, // 주문 수량\n                \"imageUrl\": \"testUrl\", // 장바구니 항목 사진 URL\n                \"createdAt\": \"2025-03-06T22:39:07.121733\", // 주문 시각\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\", // 주문자 UUID\n                \"createdByName\": \"hong\" // 주문자 이름\n            },\n            {\n                \"id\": \"01JNNTWTB8FWV6EFSG36GMBFH3\",\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\",\n                \"cafeMenuId\": 50,\n                \"isPersonalCup\": false,\n                \"quantity\": 3,\n                \"imageUrl\": \"testUrl\",\n                \"createdAt\": \"2025-03-06T22:39:07.177483\",\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n                \"createdByName\": \"hong\"\n            },\n            {\n                \"id\": \"01JNNTWTBZ9F04VDZT400H0AGF\",\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\",\n                \"cafeMenuId\": 39,\n                \"isPersonalCup\": true,\n                \"quantity\": 1,\n                \"imageUrl\": \"testUrl\",\n                \"createdAt\": \"2025-03-06T22:39:07.203078\",\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n                \"createdByName\": \"hong\"\n            },\n            {\n                \"id\": \"01JNNV69PW7V1T725RXSFSR6MF\",\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\",\n                \"cafeMenuId\": 45,\n                \"isPersonalCup\": true,\n                \"quantity\": 2,\n                \"imageUrl\": \"testUrl\",\n                \"createdAt\": \"2025-03-06T22:44:17.818121\",\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n                \"createdByName\": \"hong\"\n            },\n            {\n                \"id\": \"01JNNV69QX9GKSYDSBKE6DJKRC\",\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\",\n                \"cafeMenuId\": 50,\n                \"isPersonalCup\": false,\n                \"quantity\": 3,\n                \"imageUrl\": \"testUrl\",\n                \"createdAt\": \"2025-03-06T22:44:17.844156\",\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n                \"createdByName\": \"hong\"\n            },\n            {\n                \"id\": \"01JNNV69RWA0V0C135R8WKCCCY\",\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\",\n                \"cafeMenuId\": 39,\n                \"isPersonalCup\": true,\n                \"quantity\": 1,\n                \"imageUrl\": \"testUrl\",\n                \"createdAt\": \"2025-03-06T22:44:17.881263\",\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n                \"createdByName\": \"hong\"\n            }\n        ]\n    }\n}"}],"_postman_id":"61f60be4-b613-4319-a547-1b17dcc9ab69"},{"name":"카페 장바구니 항목 \bSSE 구독","id":"aac16ca5-3832-487a-af1b-a1f8b6512603","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true}},"request":{"method":"GET","header":[{"key":"Accept","value":"text/event-stream","type":"text"}],"url":"http://{{BREADKUN_API_BASE_URL}}/sse/cafe/carts/:cafeCartId/items/subscribe","description":"<ul>\n<li>장바구니의 항목 변경 이벤트를 실시간 수신하기 위한 SSE 엔드포인트</li>\n</ul>\n","urlObject":{"protocol":"http","path":["sse","cafe","carts",":cafeCartId","items","subscribe"],"host":["{{BREADKUN_API_BASE_URL}}"],"query":[],"variable":[{"description":{"content":"<p>[required] (String) 카페장바구니ID</p>\n","type":"text/plain"},"type":"any","value":"","key":"cafeCartId"}]}},"response":[{"id":"67ef89b1-e054-4b75-8616-d672452e001d","name":"카페 장바구니 항목 \bSSE 구독","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"text/event-stream","type":"text"}],"url":{"raw":"http://{{BREADKUN_API_BASE_URL}}/sse/cafe/carts/:cafeCartId/items/subscribe","protocol":"http","host":["{{BREADKUN_API_BASE_URL}}"],"path":["sse","cafe","carts",":cafeCartId","items","subscribe"],"variable":[{"key":"cafeCartId","value":"01JQWN0YKHAWD5G7HM332RNXC4","description":"[required] (String) 카페장바구니ID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Server","value":"nginx/1.26.2"},{"key":"Date","value":"Thu, 03 Apr 2025 01:46:21 GMT"},{"key":"Content-Type","value":"text/event-stream;charset=UTF-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Access-Control-Allow-Origin","value":"https://breadkun.com"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, PATCH, DELETE, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"Content-Type, Authorization, X-User-UUID, X-User-Name"}],"cookie":[],"responseTime":null,"body":"// 이벤트 1\nevent: cafe-cart-item-01JQWN0YKHAWD5G7HM332RNXC4\ndata: {\n  \"event\": \"CREATED\",\n  \"meta\": {\n    \"totalItems\": 3,\n    \"timestamp\": \"2025-04-03T10:46:21.686316802\"\n  },\n  \"data\": {\n    \"cafeCartItem\": [\n      {\n        \"id\": \"01JQWN7TX6E0YN2T0JD3HF0GAK\",\n        \"cafeCartId\": \"01JQWN0YKHAWD5G7HM332RNXC4\",\n        \"cafeMenuId\": 45,\n        \"isPersonalCup\": true,\n        \"quantity\": 2,\n        \"imageUrl\": \"testUrl\",\n        \"createdAt\": \"2025-04-03T10:46:21.38558233\",\n        \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n        \"createdByName\": \"테스트\",\n        \"drinkName\": \"보이차\",\n        \"drinkPrice\": 1000,\n        \"drinkTotalPrice\": 2000,\n        \"drinkCategory\": \"TEA\",\n        \"drinkTemperature\": \"ICED\",\n        \"drinkImageFilename\": \"sample.webp\",\n        \"drinkImageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f09f\"\n      },\n      {\n        \"id\": \"01JQWN7TXNDWXYY4X4MB2SGSPW\",\n        \"cafeCartId\": \"01JQWN0YKHAWD5G7HM332RNXC4\",\n        \"cafeMenuId\": 50,\n        \"isPersonalCup\": false,\n        \"quantity\": 3,\n        \"imageUrl\": \"testUrl\",\n        \"createdAt\": \"2025-04-03T10:46:21.486844807\",\n        \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n        \"createdByName\": \"테스트\",\n        \"drinkName\": \"페퍼민트\",\n        \"drinkPrice\": 1000,\n        \"drinkTotalPrice\": 3000,\n        \"drinkCategory\": \"TEA\",\n        \"drinkTemperature\": \"HOT\",\n        \"drinkImageFilename\": \"sample.webp\",\n        \"drinkImageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f07f\"\n      },\n      {\n        \"id\": \"01JQWN7V0B37EJ9KYB2GVDVY6G\",\n        \"cafeCartId\": \"01JQWN0YKHAWD5G7HM332RNXC4\",\n        \"cafeMenuId\": 39,\n        \"isPersonalCup\": true,\n        \"quantity\": 1,\n        \"imageUrl\": \"testUrl\",\n        \"createdAt\": \"2025-04-03T10:46:21.499068616\",\n        \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n        \"createdByName\": \"테스트\",\n        \"drinkName\": \"홍차 라떼\",\n        \"drinkPrice\": 1000,\n        \"drinkTotalPrice\": 1000,\n        \"drinkCategory\": \"DRINK\",\n        \"drinkTemperature\": \"ICED\",\n        \"drinkImageFilename\": \"sample.webp\",\n        \"drinkImageUrl\": \"http://breadkun/common/download?fileId=87e4f422-d0c9-473e-b35a-9d6949d4f44f\"\n      }\n    ]\n  }\n}\n\n// 이벤트 2\nevent: cafe-cart-item-01JQWN0YKHAWD5G7HM332RNXC4\ndata: {\n  \"event\": \"DELETED\",\n  \"meta\": {\n    \"totalItems\": 3,\n    \"timestamp\": \"2025-04-03T10:47:22.882466699\"\n  },\n  \"data\": {\n    \"id\": [\n      \"01JQWN7TX6E0YN2T0JD3HF0GAK\",\n      \"01JQWN7TXNDWXYY4X4MB2SGSPW\",\n      \"01JQWN7V0B37EJ9KYB2GVDVY6G\"\n    ]\n  }\n}"}],"_postman_id":"aac16ca5-3832-487a-af1b-a1f8b6512603"},{"name":"카페 장바구니 항목 생성","id":"3f055efa-6ae7-48a4-a010-83a0abee9e01","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true}},"request":{"method":"POST","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"},{"key":"X-User-UUID","value":"","description":"<p>[required] (String) 사용자ID</p>\n","type":"text"},{"key":"X-User-Name","value":"","description":"<p>[required] (String) 사용자명</p>\n","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts/:cafeCartId/items","description":"<ul>\n<li><p>장바구니 상태(status)는 ACTIVE이고,</p>\n</li>\n<li><p>장바구니 위치(cafeLocation)와 메뉴 위치(cafeLocation)가 일치 해야함</p>\n</li>\n</ul>\n<h4 id=\"body\">BODY</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Key</strong></th>\n<th><strong>Description</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>cafeMenuId</td>\n<td>[required] (String) 카페 메뉴 ID</td>\n</tr>\n<tr>\n<td>isPersonalCup</td>\n<td>[required] (Boolean) 개인컵 사용 여부</td>\n</tr>\n<tr>\n<td>quantity</td>\n<td>[required] (Int) 수량</td>\n</tr>\n<tr>\n<td>imageUrl</td>\n<td>[required] (String) 사진 URL</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"http","path":["api","cafe","carts",":cafeCartId","items"],"host":["{{BREADKUN_API_BASE_URL}}"],"query":[],"variable":[{"description":{"content":"<p>[required] (String) 카페장바구니ID</p>\n","type":"text/plain"},"type":"any","value":"","key":"cafeCartId"}]}},"response":[{"id":"350fe9e6-3350-47aa-b117-b12cd7ecf4ef","name":"카페 장바구니 항목 생성","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"},{"key":"X-User-UUID","value":"198e67bd-4e87-4540-b831-b3da10645df8","description":"[required] (String) 사용자ID","type":"text"},{"key":"X-User-Name","value":"hong","description":"[required] (String) 사용자명","type":"text"}],"body":{"mode":"raw","raw":"[\n    {\n        \"cafeMenuId\": 45,\n        \"isPersonalCup\": true,\n        \"quantity\": 2,\n        \"imageUrl\": \"testUrl\"\n    },\n    {\n        \"cafeMenuId\": 50,\n        \"isPersonalCup\": false,\n        \"quantity\": 3,\n        \"imageUrl\": \"testUrl\"\n    },\n    {\n        \"cafeMenuId\": 39,\n        \"isPersonalCup\": true,\n        \"quantity\": 1,\n        \"imageUrl\": \"testUrl\"\n    }\n]","options":{"raw":{"language":"json"}}},"url":{"raw":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts/:cafeCartId/items","protocol":"http","host":["{{BREADKUN_API_BASE_URL}}"],"path":["api","cafe","carts",":cafeCartId","items"],"variable":[{"key":"cafeCartId","value":"01JNNTNTAS3Z4ERAXK05KF2W00","description":"[required] (String) 카페장바구니ID"}]}},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"906"}],"cookie":[],"responseTime":null,"body":"{\n    \"success\": true, // 요청 성공 여부\n    \"meta\": { // 리턴 메타 데이터\n        \"totalItems\": 3, // data 전체 개수\n        \"timestamp\": \"2025-03-06T22:39:07.232177\" // 리턴 시각\n    },\n    \"data\": { // 리턴 데이터\n        \"cafeCartItem\": [ // 장바구니 항목\n            {\n                \"id\": \"01JNNTWTA77H06CKEP6R6Q15ZS\", // 장바구니 항목 ID\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\", // 장바구니 ID\n                \"cafeMenuId\": 45, // 음료 ID\n                \"isPersonalCup\": true, // 개인컵 사용 여부\n                \"quantity\": 2, // 주문 수량\n                \"imageUrl\": \"testUrl\", // 장바구니 항목 사진 URL\n                \"createdAt\": \"2025-03-06T22:39:07.121733\", // 주문 시각\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\", // 주문자 UUID\n                \"createdByName\": \"hong\" // 주문자 이름\n            },\n            {\n                \"id\": \"01JNNTWTB8FWV6EFSG36GMBFH3\",\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\",\n                \"cafeMenuId\": 50,\n                \"isPersonalCup\": false,\n                \"quantity\": 3,\n                \"imageUrl\": \"testUrl\",\n                \"createdAt\": \"2025-03-06T22:39:07.177483\",\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n                \"createdByName\": \"hong\"\n            },\n            {\n                \"id\": \"01JNNTWTBZ9F04VDZT400H0AGF\",\n                \"cafeCartId\": \"01JNNTNTAS3Z4ERAXK05KF2W00\",\n                \"cafeMenuId\": 39,\n                \"isPersonalCup\": true,\n                \"quantity\": 1,\n                \"imageUrl\": \"testUrl\",\n                \"createdAt\": \"2025-03-06T22:39:07.203078\",\n                \"createdById\": \"198e67bd-4e87-4540-b831-b3da10645df8\",\n                \"createdByName\": \"hong\"\n            }\n        ]\n    }\n}"}],"_postman_id":"3f055efa-6ae7-48a4-a010-83a0abee9e01"},{"name":"카페 장바구니 항목 다건 삭제","id":"b6cda38c-ede4-4b04-9f67-f69f4b5dfa0b","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true}},"request":{"method":"POST","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"},{"key":"X-User-UUID","value":"","description":"<p>[required] (String) 사용자ID</p>\n","type":"text"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts/items/delete","description":"<ul>\n<li><p>장바구니 상태(status)가 ACTIVE일 때만 삭제 가능</p>\n</li>\n<li><p>장바구니 항목 소유자(생성자)만 가\b능하며,</p>\n</li>\n<li><p>하나의 장바구니에서만 복수 삭제 가능</p>\n</li>\n</ul>\n<h4 id=\"body\">BODY</h4>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th><strong>Key</strong></th>\n<th><strong>Description</strong></th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>ids</td>\n<td>[required] (List) 삭제할 ID 목록</td>\n</tr>\n</tbody>\n</table>\n</div>","urlObject":{"protocol":"http","path":["api","cafe","carts","items","delete"],"host":["{{BREADKUN_API_BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"39ae05d3-b108-441a-af1f-774ff6f533cb","name":"카페 장바구니 항목 다건 삭제","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"},{"key":"X-User-UUID","value":"198e67bd-4e87-4540-b831-b3da10645df8","description":"[required] (String) 사용자ID","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"ids\": [\n        \"01JR7QEEV27PH66HKVRQ2ZJV3M\",\n        \"01JR7QECX305TX2W5B4RM6P6B5\",\n        \"01JR7QEC903W4NS3XHDAY1YHBX\"\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"http://{{BREADKUN_API_BASE_URL}}/api/cafe/carts/items/delete"},"status":"No Content","code":204,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":null}],"_postman_id":"b6cda38c-ede4-4b04-9f67-f69f4b5dfa0b"}],"id":"b0180e42-ad94-491c-91d6-0202993c9840","_postman_id":"b0180e42-ad94-491c-91d6-0202993c9840","description":""}],"id":"e7fa926a-4fae-45c5-be27-5883e9e86080","description":"<p><strong>카페 서비스와 관련된 기능을 제공하며, 카페 메뉴와 카페 장바구니 두 가지로 이루어져 있습니다.</strong></p>\n","_postman_id":"e7fa926a-4fae-45c5-be27-5883e9e86080"},{"name":"Feed","item":[{"name":"DailyBakery","item":[{"name":"오늘의 빵 조회","id":"648d284e-6b82-46f6-b487-d0adbf8bb54f","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true}},"request":{"method":"GET","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"}],"url":"http://{{BREADKUN_API_BASE_URL}}/api/feed/daily-bakery/today","urlObject":{"protocol":"http","path":["api","feed","daily-bakery","today"],"host":["{{BREADKUN_API_BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"fc617dea-aee2-421a-af79-33b69961cde6","name":"오늘의 빵 조회","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"}],"url":"http://{{BREADKUN_API_BASE_URL}}/api/feed/daily-bakery/today"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"461"}],"cookie":[],"responseTime":null,"body":"{\n    \"success\": true,\n    \"meta\": {\n        \"totalItems\": 1,\n        \"timestamp\": \"2025-11-19T00:29:40.11417\"\n    },\n    \"data\": {\n        \"dailyBakery\": {\n            \"id\": \"691c90856c4b7a12feb2b5e3\",\n            \"name\": \"할라피뇨베이글\",\n            \"imageUrl\": \"https://objectstorage.ap-chuncheon-1.oraclecloud.com/p/ZYoh0hjAgJjz1AxHBBluPqJ9Fi3UcaTG5KmrUYl7FFGJ9pZkl6a8Q_vnQYz2npDe/n/ax8vztmm9ho3/b/bucket-20240905-2203/o/breadkun/breadImgs/13.webp\",\n            \"servedAt\": \"2025-11-19T09:00:00\",\n            \"createdAt\": \"2025-11-19T09:28:05.106\",\n            \"createdById\": \"jiwon\"\n        }\n    }\n}"}],"_postman_id":"648d284e-6b82-46f6-b487-d0adbf8bb54f"}],"id":"3637c2a9-2f5f-471f-b75f-f00c44746647","_postman_id":"3637c2a9-2f5f-471f-b75f-f00c44746647","description":""},{"name":"TrendingNews","item":[{"name":"뉴스 전체 조회(작업중)","id":"2685f836-9564-44fc-9e50-9b6e912df9b8","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"accept":true}},"request":{"method":"GET","header":[{"key":"Accept","value":"application/vnd.breadkun.v1+json","type":"text"}],"url":"http://{{BREADKUN_API_BASE_URL}}/api/feed/trending-news","description":"<ul>\n<li>유효한 메뉴(available = true)만 리턴</li>\n</ul>\n","urlObject":{"protocol":"http","path":["api","feed","trending-news"],"host":["{{BREADKUN_API_BASE_URL}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"2685f836-9564-44fc-9e50-9b6e912df9b8"}],"id":"c2da6ea5-5f5c-4bd9-b4ea-152111f69655","_postman_id":"c2da6ea5-5f5c-4bd9-b4ea-152111f69655","description":""}],"id":"4df4c2f5-5cf9-4fe8-a87c-927c91cdee40","description":"<p><strong>사용자에게 제공할 최신 정보나 콘텐츠(예: 오늘의 빵, 실시간 소식 등)를 전달하는 역할을 담당하는 영역입니다.</strong></p>\n","_postman_id":"4df4c2f5-5cf9-4fe8-a87c-927c91cdee40"}],"id":"fee685af-4077-4837-9169-8d1cc33c42c9","description":"<p><strong>공용 API 입니다.</strong></p>\n","_postman_id":"fee685af-4077-4837-9169-8d1cc33c42c9"}],"event":[{"listen":"prerequest","script":{"id":"7f1f871c-2afe-42ab-ac0f-a4694e6c9078","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"379b9089-bde9-435d-9b43-255568bbb826","type":"text/javascript","packages":{},"exec":[""]}}]}