{"info":{"_postman_id":"b49ddb92-fd68-44f0-b11e-0ebf7268cfb5","name":"\bPlus-Project","description":"

이 문서는 숙소 예약 어플을 주제로 개발한 Plus-Project의 API 문서입니다.

🌏 공동 사항

기본 URL: http://localhost:8080/api
\n
응답 형식: JSON
\n
모든 API 응답은 아래와 같은 공통 구조를 따릅니다:
\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

필드명	타입	설명
success	boolean	요청 성공 여부
message	string	응답 메시지
data	object	응답 데이터 (API마다 구조 상이)
timestamp	LocalDateTime	응답 시간

모든 시간 정보는 KST(UTC+9) 기준입니다.

🗒️ 테스트 환경 설정

프로그램과 로컬 Redis 및 MySQL이 정상 실행 중이어야 합니다.
\n
메인 데이터베이스는 MySQL 입니다.
\n
Redis는 검색어 저장 및 캐시 처리 등에 사용됩니다.
\n

📁 주요 API 목록

회원가입/로그인
\n
숙소
\n
숙소 조회/검색
\n
인기 검색어 조회
\n
예약
\n
후기
\n
찜
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"44682451","collectionId":"b49ddb92-fd68-44f0-b11e-0ebf7268cfb5","publishedId":"2sB34hEzdY","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-07-14T08:12:05.000Z"},"item":[{"name":"회원가입/로그인","item":[{"name":"회원가입","event":[{"listen":"test","script":{"id":"1d6f30fe-3f1a-41b8-88d9-a1079b27508d","exec":[""],"type":"text/javascript","packages":{}}}],"id":"df58a19a-8f0b-4c39-a498-21f4840004ba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"김유저\",\r\n\t\"nickname\": \"test\",\r\n\t\"email\": \"test@email.com\",\r\n \"password\": \"Password123!\",\r\n \"phoneNumber\": \"+821011112222\",\r\n \"residence\": \"대한민국\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/auth/signup","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
name	Request Body	String	이름	Y
nickname	Request Body	String	닉네임 ~ 아이디	Y
email	Request Body	String	이메일	Y
password	Request Body	String	비밀번호	Y
phoneNumber	Request Body	String	전화번호	Y
residence	Request Body	String	거주 국가	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","auth","signup"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"d4957f1a-2719-497d-9600-5cba520c790f","name":"회원가입 예시","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"김유저\",\r\n\t\"nickname\": \"test\",\r\n\t\"email\": \"test@email.com\",\r\n \"password\": \"Password123!\",\r\n \"phoneNumber\": \"+821011112222\",\r\n \"residence\": \"대한민국\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/auth/signup"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 10:21:27 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"회원가입이 성공했습니다.\",\n \"data\": {\n \"id\": 1,\n \"name\": \"김유저\",\n \"nickname\": \"test\",\n \"email\": \"test@email.com\",\n \"userRole\": \"GUEST\",\n \"createdAt\": \"2025-07-14T19:21:27.035002\"\n },\n \"timestamp\": \"2025-07-14T19:21:27.064986\"\n}"}],"_postman_id":"df58a19a-8f0b-4c39-a498-21f4840004ba"},{"name":"로그인","event":[{"listen":"test","script":{"id":"1d6f30fe-3f1a-41b8-88d9-a1079b27508d","exec":["var jsonData = pm.response.json();","","// 응답이 200번대일 때만 저장","if (pm.response.code >= 200 && pm.response.code < 300 && jsonData && jsonData.data && jsonData.data.token) {"," // \"Bearer \" 제거하고 토큰값만 저장"," var token = jsonData.data.token.replace(/^Bearer\\s+/, '');"," pm.environment.set(\"access_token\", token);","}",""],"type":"text/javascript","packages":{}}}],"id":"7db7bd94-6c93-4c8f-a40b-1ccea6c9d121","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"nickname\": \"test\",\r\n \"password\": \"Password123!\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/auth/login","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
nickname	Request Body	String	닉네임 ~ 아이디	Y
password	Request Body	String	비밀번호	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","auth","login"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"66d0eb5d-40dc-4620-9bde-86c7632bf8b2","name":"로그인 예시","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"nickname\": \"test\",\r\n \"password\": \"Password123!\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/auth/login"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 06:43:46 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"로그인에 성공했습니다.\",\n \"data\": {\n \"token\": \"Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxIiwibmlja25hbWUiOiJ0ZXN0IiwidXNlclJvbGUiOiJHVUVTVCIsImV4cCI6MTc1MjQ3OTAyNiwiaWF0IjoxNzUyNDc1NDI2fQ.npqLZ9sXhbpYwV_kgq3LbLaTEliSTkRb7XAzuTPyLHM\"\n },\n \"timestamp\": \"2025-07-14T15:43:46.325056\"\n}"}],"_postman_id":"7db7bd94-6c93-4c8f-a40b-1ccea6c9d121"},{"name":"현재 회원 정보 조회","id":"eaa0c0c7-fffd-4cca-8ed2-64c1322b5d7f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:8080/api/users/me","urlObject":{"protocol":"http","port":"8080","path":["api","users","me"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"e582cfa2-6f01-43a3-ac29-3ad4a20cc35e","name":"현재 회원 정보 조회 예시","originalRequest":{"method":"GET","header":[],"url":"http://localhost:8080/api/users/me"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:40:10 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"현재사용자 조회에 성공했습니다.\",\n \"data\": {\n \"id\": 1,\n \"name\": \"김유저\",\n \"nickname\": \"test\",\n \"email\": \"test@email.com\",\n \"userRole\": \"HOST\",\n \"createdAt\": \"2025-07-14T16:39:24.844725\"\n },\n \"timestamp\": \"2025-07-14T16:40:10.058533\"\n}"}],"_postman_id":"eaa0c0c7-fffd-4cca-8ed2-64c1322b5d7f"},{"name":"역할변경","id":"5fcb10b5-940f-49fe-afe2-9a475db104ff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"role\": \"HOST\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/users/1","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
userId	Path Variable	Long	유저 id	Y
role	Request Body	String	역할	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","users","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"5f282928-f5e7-4e4a-95d0-9a331e8c4098","name":"역할변경 예시","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"role\": \"HOST\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/users/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:40:04 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"역할이 변경되었습니다.\",\n \"data\": {\n \"role\": \"HOST\"\n },\n \"timestamp\": \"2025-07-14T16:40:04.694784\"\n}"}],"_postman_id":"5fcb10b5-940f-49fe-afe2-9a475db104ff"},{"name":"회원탈퇴","id":"23b4e8db-43f7-4c97-a7e0-16d56e99ebe7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"inputPassword\": \"Password123!\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/users/1","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
userId	Path Variable	Long	유저 id	Y
inputPassword	Request Body	String	비밀번호	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","users","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"2c55c880-6876-41ef-bd1c-3a72f0546366","name":"회원 탈퇴 예시","originalRequest":{"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n \"inputPassword\": \"Password123!\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/users/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:51:11 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"유저가 삭제되었습니다.\",\n \"data\": null,\n \"timestamp\": \"2025-07-14T16:51:11.232889\"\n}"}],"_postman_id":"23b4e8db-43f7-4c97-a7e0-16d56e99ebe7"}],"id":"b756a26a-fa62-408b-ace8-6bd0914622f6","description":"

회원 도메인은 회원의 가입, 조회, 수정, 삭제 및 로그인 기능을 담당합니다.
\n
로그인 시 발급되는 토큰은 인증이 필요한 API 요청 시 사용되며,
조회 API를 제외한 대부분의 요청에는 토큰이 필요합니다.
\n

\n","_postman_id":"b756a26a-fa62-408b-ace8-6bd0914622f6"},{"name":"숙소","item":[{"name":"숙소 등록","id":"95bc0b36-5a12-43cd-95d5-beac0ea9bc76","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"accommodationName\": \"00숙소 101호\",\n \"address\": \"제주특별시 행복동 123 00숙소 101호\",\n \"city\": \"제주특별시\",\n \"capacity\": 2,\n \"description\": \"설명\",\n \"roomType\": \"더블\",\n \"image\": \"image.url\",\n \"services\": \"무료 Wi-Fi 제공, 조식 제공, 오션뷰\",\n \"price\": 68000\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/accommodations","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
accommodationName	Request Body	String	예약숙박일	Y
address	Request Body	String	숙소명	Y
city	Request Body	String	도시명	Y
capacity	Request Body	Integer	최대 수용 인원	Y
description	Request Body	String	소개글	Y
roomType	Request Body	String	방 타입	Y
image	Request Body	String	숙소 이미지 URL	Y
services	Request Body	String	제공되는 서비스	Y
price	Request Body	Double	가격	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","accommodations"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"f523db50-9417-4621-a0c8-817bc4dbeb7f","name":"숙소 생성 예시","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"accommodationName\": \"00숙소 101호\",\n \"address\": \"제주특별시 행복동 123 00숙소 101호\",\n \"city\": \"제주특별시\",\n \"capacity\": 2,\n \"description\": \"설명\",\n \"roomType\": \"더블\",\n \"image\": \"image.url\",\n \"services\": \"무료 Wi-Fi 제공, 조식 제공, 오션뷰\",\n \"price\": 68000\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/accommodations"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:40:16 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"숙소 등록이 완료되었습니다.\",\n \"data\": {\n \"id\": 1,\n \"accommodationName\": \"00숙소 101호\",\n \"address\": \"제주특별시 행복동 123 00숙소 101호\",\n \"city\": \"제주특별시\",\n \"capacity\": 2,\n \"description\": \"설명\",\n \"roomType\": \"더블\",\n \"image\": \"image.url\",\n \"services\": \"무료 Wi-Fi 제공, 조식 제공, 오션뷰\",\n \"price\": 68000,\n \"hostId\": 1\n },\n \"timestamp\": \"2025-07-14T16:40:16.27056\"\n}"}],"_postman_id":"95bc0b36-5a12-43cd-95d5-beac0ea9bc76"},{"name":"숙소 상세 정보 수정","id":"b7baceeb-dabe-4749-9724-d627ed04f6cc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"price\": 65000\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/accommodations/1","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
accommodationId	Path Variable	Long	숙소 id	Y
accommodationName	Request Body	String	예약숙박일	N
address	Request Body	String	숙소명	N
city	Request Body	String	도시명	N
capacity	Request Body	Integer	최대 수용 인원	N
description	Request Body	String	소개글	N
roomType	Request Body	String	방 타입	N
image	Request Body	String	숙소 이미지 URL	N
services	Request Body	String	제공되는 서비스	N
price	Request Body	Double	가격	N

","urlObject":{"protocol":"http","port":"8080","path":["api","accommodations","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"5e89399f-c436-4124-b787-e9b0d88bc8fd","name":"숙소 상세 정보 수정 예시","originalRequest":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"price\": 65000\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/accommodations/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:40:28 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"숙소 상세 정보 수정이 완료되었습니다.\",\n \"data\": {\n \"id\": 1,\n \"accommodationName\": \"00숙소 101호\",\n \"address\": \"제주특별시 행복동 123 00숙소 101호\",\n \"city\": \"제주특별시\",\n \"capacity\": 2,\n \"description\": \"설명\",\n \"roomType\": \"더블\",\n \"image\": \"image.url\",\n \"services\": \"무료 Wi-Fi 제공, 조식 제공, 오션뷰\",\n \"price\": 65000,\n \"hostId\": 1\n },\n \"timestamp\": \"2025-07-14T16:40:28.572401\"\n}"}],"_postman_id":"b7baceeb-dabe-4749-9724-d627ed04f6cc"},{"name":"숙소 삭제","id":"310f2094-7f3a-43df-8bf3-23d99149d6da","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"http://localhost:8080/api/accommodations/1","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
accommodationId	Path Variable	Long	숙소 id	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","accommodations","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"8d147c1f-9567-48c1-b46f-63f6352f51bc","name":"숙소 삭제 예시","originalRequest":{"method":"DELETE","header":[],"url":"http://localhost:8080/api/accommodations/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:50:59 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"숙소 정보 삭제가 완료되었습니다.\",\n \"data\": null,\n \"timestamp\": \"2025-07-14T16:50:59.427462\"\n}"}],"_postman_id":"310f2094-7f3a-43df-8bf3-23d99149d6da"}],"id":"30c73af7-dfe8-4704-958a-47c5df838399","description":"

숙소 도메인은 숙소 등록, 수정, 삭제 기능을 담당합니다.
\n
해당 요청은 역할이 호스트로 등록된 회원에게만 권한이 있습니다.
\n

\n","_postman_id":"30c73af7-dfe8-4704-958a-47c5df838399"},{"name":"숙소 조회/검색","item":[{"name":"숙소 조회 (검색어)","id":"d90833cd-cc8d-4873-a410-5707626c38b1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"localhost:8080/api/accommodations/v3/search/keyword?keyword=제주","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
keyword	Request Param	String	검색한 키워드	Y
page	Request Param	int	페이지 번호	N
size	Request Param	int	페이지 크기	N

","urlObject":{"port":"8080","path":["api","accommodations","v3","search","keyword"],"host":["localhost"],"query":[{"key":"keyword","value":"제주"}],"variable":[]}},"response":[{"id":"1458ccdf-2d74-4026-83c2-1ba2958b9f15","name":"숙소 조회 (검색어) 예시","originalRequest":{"method":"GET","header":[],"url":{"raw":"localhost:8080/api/accommodations/v3/search/keyword?keyword=제주","host":["localhost"],"port":"8080","path":["api","accommodations","v3","search","keyword"],"query":[{"key":"keyword","value":"제주"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:40:37 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"content\": [\n {\n \"id\": 1,\n \"accommodationName\": \"00숙소 101호\",\n \"address\": \"제주특별시 행복동 123 00숙소 101호\",\n \"city\": \"제주특별시\",\n \"description\": \"설명\",\n \"roomType\": \"더블\",\n \"image\": \"image.url\",\n \"services\": \"무료 Wi-Fi 제공, 조식 제공, 오션뷰\",\n \"price\": 65000,\n \"hostId\": 1\n }\n ],\n \"pageable\": {\n \"pageNumber\": 0,\n \"pageSize\": 10,\n \"sort\": {\n \"empty\": true,\n \"sorted\": false,\n \"unsorted\": true\n },\n \"offset\": 0,\n \"paged\": true,\n \"unpaged\": false\n },\n \"last\": true,\n \"totalPages\": 1,\n \"totalElements\": 1,\n \"first\": true,\n \"size\": 10,\n \"number\": 0,\n \"sort\": {\n \"empty\": true,\n \"sorted\": false,\n \"unsorted\": true\n },\n \"numberOfElements\": 1,\n \"empty\": false\n}"}],"_postman_id":"d90833cd-cc8d-4873-a410-5707626c38b1"},{"name":"숙소 조회 (지역 선택)","id":"9a7365fe-fd3e-452d-9c1d-948ddf2dba0c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"localhost:8080/api/accommodations/v3/search/city?city=제주특별시","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
city	Request Param	String	선택한 도시명	Y
page	Request Param	int	페이지 번호	N
size	Request Param	int	페이지 크기	N

","urlObject":{"port":"8080","path":["api","accommodations","v3","search","city"],"host":["localhost"],"query":[{"key":"city","value":"제주특별시"}],"variable":[]}},"response":[{"id":"b6d5f0c4-8cc1-4c07-af59-85abaa8e3d84","name":"숙소 조회 (지역 선택) 예시","originalRequest":{"method":"GET","header":[],"url":{"raw":"localhost:8080/api/accommodations/v3/search/city?city=제주특별시","host":["localhost"],"port":"8080","path":["api","accommodations","v3","search","city"],"query":[{"key":"city","value":"제주특별시"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:40:42 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"content\": [\n {\n \"id\": 1,\n \"accommodationName\": \"00숙소 101호\",\n \"address\": \"제주특별시 행복동 123 00숙소 101호\",\n \"city\": \"제주특별시\",\n \"description\": \"설명\",\n \"roomType\": \"더블\",\n \"image\": \"image.url\",\n \"services\": \"무료 Wi-Fi 제공, 조식 제공, 오션뷰\",\n \"price\": 65000,\n \"hostId\": 1\n }\n ],\n \"pageable\": {\n \"pageNumber\": 0,\n \"pageSize\": 10,\n \"sort\": {\n \"empty\": true,\n \"sorted\": false,\n \"unsorted\": true\n },\n \"offset\": 0,\n \"paged\": true,\n \"unpaged\": false\n },\n \"last\": true,\n \"totalPages\": 1,\n \"totalElements\": 1,\n \"first\": true,\n \"size\": 10,\n \"number\": 0,\n \"sort\": {\n \"empty\": true,\n \"sorted\": false,\n \"unsorted\": true\n },\n \"numberOfElements\": 1,\n \"empty\": false\n}"}],"_postman_id":"9a7365fe-fd3e-452d-9c1d-948ddf2dba0c"}],"id":"7597fe5f-887b-46da-b045-215f3b8693ae","description":"

검색어를 통한 숙소 조회 기능과 지역 선택을 통한 숙소 조회 기능을 담당합니다.
\n
숙소 조회 기능에는 모두 캐싱을 적용하여 성능을 개선하였습니다.
\n

\n","_postman_id":"7597fe5f-887b-46da-b045-215f3b8693ae"},{"name":"인기 검색어 조회","item":[{"name":"인기 검색어 조회","id":"4e0f61ab-3614-4911-9472-5e68e9e232c2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:8080/api/trending","description":"","urlObject":{"protocol":"http","port":"8080","path":["api","trending"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"61602cc4-adf2-4b4d-aedc-387de3501ba1","name":"인기 검색어 조회 예시","originalRequest":{"method":"GET","header":[],"url":"http://localhost:8080/api/trending"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:41:47 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"인기 검색어 순위 조회 결과입니다.\",\n \"data\": [\n {\n \"rank\": 1,\n \"keyword\": \"제주도\"\n },\n {\n \"rank\": 2,\n \"keyword\": \"부산\"\n },\n {\n \"rank\": 3,\n \"keyword\": \"포항\"\n },\n {\n \"rank\": 4,\n \"keyword\": \"여수\"\n },\n {\n \"rank\": 5,\n \"keyword\": \"바다\"\n },\n {\n \"rank\": 6,\n \"keyword\": \"수원\"\n },\n {\n \"rank\": 7,\n \"keyword\": \"서울\"\n },\n {\n \"rank\": 8,\n \"keyword\": \"전주\"\n },\n {\n \"rank\": 9,\n \"keyword\": \"속초\"\n },\n {\n \"rank\": 10,\n \"keyword\": \"인천\"\n }\n ],\n \"timestamp\": \"2025-07-14T16:41:47.39644\"\n}"}],"_postman_id":"4e0f61ab-3614-4911-9472-5e68e9e232c2"}],"id":"e4277708-908f-47ec-851d-ff65d0b3312f","description":"

검색어를 통한 숙소 조회 시, 입력한 키워드는 단어 단위로 분리되어 각각의 검색 횟수가 저장됩니다.
\n
이후 인기 검색어 조회 기능을 통해 자주 검색한 단어를 1위부터 10위까지 확인할 수 있습니다.
\n

\n","_postman_id":"e4277708-908f-47ec-851d-ff65d0b3312f"},{"name":"예약","item":[{"name":"숙소 예약","id":"68843f7e-76d6-4d43-b08c-d051b128f20b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"guestCount\": \"2\",\n \"checkInDate\": \"2025-07-08\",\n \"checkOutDate\" : \"2025-07-10\",\n \"accommodationAddress\" : \"제주특별시 행복동 123 00숙소 101호\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/reservations","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
guestCount	Request Body	Long	예약인원	Y
checkInDate	Request Body	LocalDate	예약숙박일	Y
checkOutDate	Request Body	LocalDate	예약숙박일	Y
accommodationAddress	Request Body	String	숙소명	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","reservations"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"22b04f3d-539b-48a8-b4e8-b8298f746fbb","name":"숙소 예약 예시","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"guestCount\": \"2\",\n \"checkInDate\": \"2025-07-08\",\n \"checkOutDate\" : \"2025-07-10\",\n \"accommodationAddress\" : \"제주특별시 행복동 123 00숙소 101호\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/reservations"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:41:59 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"예약 성공!\",\n \"data\": {\n \"id\": 1,\n \"accommodationAddress\": \"제주특별시 행복동 123 00숙소 101호\",\n \"guestCount\": 2,\n \"checkInDate\": \"2025-07-08\"\n },\n \"timestamp\": \"2025-07-14T16:41:59.152527\"\n}"}],"_postman_id":"68843f7e-76d6-4d43-b08c-d051b128f20b"},{"name":"예약 전체 조회","id":"cdef79cc-b2c7-4879-bfce-1e76a7ae13e3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:8080/api/reservations","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
page	Request Param	int	페이지 번호	N
size	Request Param	int	페이지 크기	N

","urlObject":{"protocol":"http","port":"8080","path":["api","reservations"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"68598745-7eff-4dd5-91d1-7aab0c786273","name":"예약 전체 조회 예시","originalRequest":{"method":"GET","header":[],"url":"http://localhost:8080/api/reservations"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:42:06 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"조회 성공!\",\n \"data\": {\n \"content\": [\n {\n \"id\": 1,\n \"accommodationAddress\": \"제주특별시 행복동 123 00숙소 101호\",\n \"guestCount\": 2,\n \"checkInDate\": \"2025-07-08\"\n }\n ],\n \"pageable\": {\n \"pageNumber\": 0,\n \"pageSize\": 10,\n \"sort\": {\n \"empty\": true,\n \"sorted\": false,\n \"unsorted\": true\n },\n \"offset\": 0,\n \"paged\": true,\n \"unpaged\": false\n },\n \"last\": true,\n \"totalPages\": 1,\n \"totalElements\": 1,\n \"first\": true,\n \"size\": 10,\n \"number\": 0,\n \"sort\": {\n \"empty\": true,\n \"sorted\": false,\n \"unsorted\": true\n },\n \"numberOfElements\": 1,\n \"empty\": false\n },\n \"timestamp\": \"2025-07-14T16:42:06.584086\"\n}"}],"_postman_id":"cdef79cc-b2c7-4879-bfce-1e76a7ae13e3"},{"name":"예약 인원 수정","id":"010e31ad-2fbf-4135-adb1-f65f733c48b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"guestCount\": 1\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/reservations/1","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
reservationId	Path Variable	Long	예약정보의 id 값	Y
guestCount	Request Body	Long	변경할 인원수	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","reservations","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"9cb50a2c-629a-442c-b5a7-a8bb29b81ef9","name":"예약 인원 수정 예시","originalRequest":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n \"guestCount\": 1\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/reservations/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:42:13 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"변경 성공!\",\n \"data\": {\n \"id\": 1,\n \"accommodationAddress\": \"제주특별시 행복동 123 00숙소 101호\",\n \"guestCount\": 1,\n \"checkInDate\": \"2025-07-08\"\n },\n \"timestamp\": \"2025-07-14T16:42:13.020776\"\n}"}],"_postman_id":"010e31ad-2fbf-4135-adb1-f65f733c48b5"},{"name":"예약 취소","id":"708adf0b-f7ed-4ee0-8494-52bcb4fb40b1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"http://localhost:8080/api/reservations/1","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
reservationId	Path Variable	Long	예약정보의 id 값	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","reservations","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"3ad8dff5-aefe-499f-8c67-0b1e067317a1","name":"예약 삭제 예시","originalRequest":{"method":"DELETE","header":[],"url":"http://localhost:8080/api/reservations/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 06:48:11 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"삭제 성공!\",\n \"data\": null,\n \"timestamp\": \"2025-07-14T15:48:11.575483\"\n}"}],"_postman_id":"708adf0b-f7ed-4ee0-8494-52bcb4fb40b1"}],"id":"683ef631-327b-434e-8ec1-7c7a81f1b1fc","description":"

예약 도메인은 숙소 예약, 예약 전체 조회, 예약 인원 수정 기능을 담당합니다.

\n","_postman_id":"683ef631-327b-434e-8ec1-7c7a81f1b1fc"},{"name":"후기","item":[{"name":"후기 등록","id":"68920d1e-ca74-4573-966a-79121c838080","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"rating\": 5.0,\n \"content\": \"최고의 숙소입니다!\",\n \"imageUrl\": \"image.url\",\n \"reservationId\": 1\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/reviews","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터 타입	설명	필수값
rating	Request Body	double	평점	Y
content	Request Body	String	후기 내용	Y
imageUrl	Request Body	String	후기 이미지 URL	N
reservationId	Request Body	Long	후기 대상 예약 id	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","reviews"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"36d4fb07-f95a-433b-9ff7-c0d1cb4d34c2","name":"후기 작성 예시","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"rating\": 5.0,\n \"content\": \"최고의 숙소입니다!\",\n \"imageUrl\": \"image.url\",\n \"reservationId\": 1\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/reviews"},"status":"Created","code":201,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:42:20 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"후기 작성이 완료되었습니다.\",\n \"data\": {\n \"reviewId\": 1,\n \"nickname\": \"test\",\n \"rating\": 5,\n \"content\": \"최고의 숙소입니다!\",\n \"createAt\": \"2025-07-14T16:42:20.698759\"\n },\n \"timestamp\": \"2025-07-14T16:42:20.704366\"\n}"}],"_postman_id":"68920d1e-ca74-4573-966a-79121c838080"},{"name":"후기 단건 조회","id":"a1b2f36e-f0f9-4031-9ba6-96439d89e935","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:8080/api/reviews/1","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
reviewId	Path Variable	Long	후기 id	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","reviews","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"d4712151-06f2-45f3-b897-4abbefe84236","name":"후기 단건 조회 예시","originalRequest":{"method":"GET","header":[],"url":"http://localhost:8080/api/reviews/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:42:25 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"후기 조회가 완료되었습니다.\",\n \"data\": {\n \"reviewId\": 1,\n \"userDto\": {\n \"userId\": 1,\n \"nickname\": \"test\"\n },\n \"accommodationDto\": {\n \"accommodationId\": 1,\n \"name\": \"00숙소 101호\"\n },\n \"rating\": 5,\n \"content\": \"최고의 숙소입니다!\",\n \"imageUrl\": \"image.url\",\n \"createdAt\": \"2025-07-14T16:42:20.698759\"\n },\n \"timestamp\": \"2025-07-14T16:42:25.800534\"\n}"}],"_postman_id":"a1b2f36e-f0f9-4031-9ba6-96439d89e935"},{"name":"후기 전체 조회","id":"39237c09-0a55-4aff-b00e-5d965ae58618","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:8080/api/reviews","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터 타입	설명	필수값
accommodationId	Request Param	Long	후기 대상 숙소 id	\bN
userId	Request Param	Long	후기 대상 유저	N
page	Request Param	Integer	페이지 번호	N
size	Request Param	Integer	페이지 크기	N

","urlObject":{"protocol":"http","port":"8080","path":["api","reviews"],"host":["localhost"],"query":[{"disabled":true,"key":"accommodationId","value":"1"},{"disabled":true,"key":"userId","value":"1"}],"variable":[]}},"response":[{"id":"c33d933b-6d3e-4fba-ac44-8ec8b903f933","name":"후기 전체 조회 예시","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://localhost:8080/api/reviews","protocol":"http","host":["localhost"],"port":"8080","path":["api","reviews"],"query":[{"key":"accommodationId","value":"1","type":"text","disabled":true},{"key":"userId","value":"1","type":"text","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:42:32 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"후기 목록 조회가 완료되었습니다.\",\n \"data\": {\n \"reviews\": [\n {\n \"reviewId\": 1,\n \"userDto\": {\n \"userId\": 1,\n \"nickname\": \"test\"\n },\n \"accommodationDto\": {\n \"accommodationId\": 1,\n \"name\": \"00숙소 101호\"\n },\n \"rating\": 5,\n \"content\": \"최고의 숙소입니다!\",\n \"imageUrl\": \"image.url\",\n \"createdAt\": \"2025-07-14T16:42:20.698759\"\n }\n ],\n \"page\": {\n \"currentPage\": 1,\n \"size\": 10,\n \"totalPages\": 1,\n \"totalElements\": 1\n }\n },\n \"timestamp\": \"2025-07-14T16:42:32.067155\"\n}"}],"_postman_id":"39237c09-0a55-4aff-b00e-5d965ae58618"},{"name":"후기 수정","id":"4fa4a252-1490-42ac-87e6-5a9498645812","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n\t\t\"rating\": 4.5,\n\t\t\"content\": \"숙소는 다 좋았는데 체크아웃 서비스가 아쉬웠습니다.\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/reviews/1","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터 타입	설명	필수값
reviewId	Request Param	Long	후기 id	Y
rating	Request Body	double	평점	Y
content	Request Body	String	후기 내용	Y
imageUrl	Request Body	String	후기 이미지 URL	N

","urlObject":{"protocol":"http","port":"8080","path":["api","reviews","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"a7d9a3c5-b1e3-4676-b572-0e7a9a30297f","name":"후기 수정 예시","originalRequest":{"method":"PATCH","header":[],"body":{"mode":"raw","raw":"{\n\t\t\"rating\": 4.5,\n\t\t\"content\": \"숙소는 다 좋았는데 체크아웃 서비스가 아쉬웠습니다.\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:8080/api/reviews/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:42:37 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"후기 수정이 완료되었습니다.\",\n \"data\": {\n \"reviewId\": 1,\n \"nickname\": \"test\",\n \"rating\": 4.5,\n \"content\": \"숙소는 다 좋았는데 체크아웃 서비스가 아쉬웠습니다.\",\n \"imageUrl\": null,\n \"createdAt\": \"2025-07-14T16:42:20.698759\",\n \"modifiedAt\": \"2025-07-14T16:42:37.283136\"\n },\n \"timestamp\": \"2025-07-14T16:42:37.287983\"\n}"}],"_postman_id":"4fa4a252-1490-42ac-87e6-5a9498645812"},{"name":"후기 삭제","id":"e07848a6-0b51-4257-a92b-f12b59d3b256","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"http://localhost:8080/api/reviews/1","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터 타입	설명	필수값
reviewId	Request Param	Long	후기 id	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","reviews","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"3934755e-f530-4aa5-9eea-6ed1b5145cab","name":"후기 삭제 예시","originalRequest":{"method":"DELETE","header":[],"url":"http://localhost:8080/api/reviews/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:46:19 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"후기 삭제가 완료되었습니다.\",\n \"data\": null,\n \"timestamp\": \"2025-07-14T16:46:19.909317\"\n}"}],"_postman_id":"e07848a6-0b51-4257-a92b-f12b59d3b256"}],"id":"a57495ab-9b00-4913-a304-677d54bc2b28","description":"

후기 도메인은 후기 등록, 조회, 수정, 삭제 기능을 담당합니다.
\n
한 예약 당 하나의 후기만 등록이 가능합니다.
\n

\n","_postman_id":"a57495ab-9b00-4913-a304-677d54bc2b28"},{"name":"찜","item":[{"name":"찜하기","id":"28653dd8-54b0-49a0-9e70-8a01f3467533","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"POST","header":[],"url":"http://localhost:8080/api/favorites/1","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
accommodationId	Path Variable	Long	숙소 id	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","favorites","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"7b780346-ebd4-4966-a5fe-e8af6790e8df","name":"찜하기 예시","originalRequest":{"method":"POST","header":[],"url":"http://localhost:8080/api/favorites/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:42:44 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"찜하기 성공!\",\n \"data\": {\n \"accommodationName\": \"00숙소 101호\",\n \"nickname\": \"test\"\n },\n \"timestamp\": \"2025-07-14T16:42:44.878514\"\n}"}],"_postman_id":"28653dd8-54b0-49a0-9e70-8a01f3467533"},{"name":"찜 목록 조회","id":"21e53138-eb8a-4bae-82f8-019fe41ec154","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:8080/api/favorites/v2","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
page	Request Param	int	페이지 번호	N
size	Request Param	int	페이지 크기	N

","urlObject":{"protocol":"http","port":"8080","path":["api","favorites","v2"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"7b6239ad-b66c-49d5-aec8-8f38af6ece49","name":"찜 전체 조회 예시","originalRequest":{"method":"GET","header":[],"url":"http://localhost:8080/api/favorites/v2"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 12:11:08 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"조회 성공!\",\n \"data\": [\n {\n \"accommodationName\": \"00숙소 101호\",\n \"nickname\": \"test\"\n }\n ],\n \"timestamp\": null\n}"}],"_postman_id":"21e53138-eb8a-4bae-82f8-019fe41ec154"},{"name":"찜취소하기","id":"0d897fce-0971-465b-b513-b5d2cb9e3725","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{access_token}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"http://localhost:8080/api/favorites/1","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

키	위치	데이터타입	설명	필수값
accommodationId	Path Variable	Long	숙소 id	Y

","urlObject":{"protocol":"http","port":"8080","path":["api","favorites","1"],"host":["localhost"],"query":[],"variable":[]}},"response":[{"id":"02eee6ed-e365-400d-9729-23ea18299c3c","name":"찜취소하기 예시","originalRequest":{"method":"DELETE","header":[],"url":"http://localhost:8080/api/favorites/1"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"0"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Jul 2025 07:42:57 GMT"},{"key":"Keep-Alive","value":"timeout=60"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": true,\n \"message\": \"삭제 성공!\",\n \"data\": null,\n \"timestamp\": \"2025-07-14T16:42:57.427624\"\n}"}],"_postman_id":"0d897fce-0971-465b-b513-b5d2cb9e3725"}],"id":"68ea4af2-8f24-4ebb-8dd9-fde4e3965628","description":"

찜 도메인은 마음에 드는 숙소를 대상으로 찜하기, 찜 목록 조회, 찜 취소하기 기능을 담당합니다.
\n
찜 목록 조회 기능에는 캐싱을 적용하여 성능을 개선하였습니다.
\n

\n","_postman_id":"68ea4af2-8f24-4ebb-8dd9-fde4e3965628"}]}