Bottle Note API 문서

POST http://localhost:8080/api/v1/reports/user
Content-Type: application/json

{
  "userId": "일", // 숫자 값이 필요한데 문자열 값이 들어온 경우
  "reportUserId": 0,
  "type": "SPAM",
  "content": "내용"
}

{
  "success": false,
  "code": 400,
  "data": [],
  "errors": {
    "message": "'userId' 필드의 값이 잘못되었습니다. 해당 필드의 값의 타입을 확인해주세요."
  },
  "meta": {
    "serverVersion": "1.0.0",
    "serverEncoding": "UTF-8",
    "serverResponseTime": "2024-04-19T22:28:52.428425",
    "serverPathVersion": "v1"
  }
}

POST http://localhost:8080/api/v1/reports/user
Content-Type: application/json

{
  "userId": "", // 필수적인 값이 없는 경우
  "reportUserId": 0,
  "type": "SPAM",
  "content": "내용"
}

{
  "success": false,
  "code": 400,
  "data": [],
  "errors": {
    "userId": "신고자 아이디는 필수입니다."
  },
  "meta": {
    "serverVersion": "1.0.0",
    "serverEncoding": "UTF-8",
    "serverResponseTime": "2024-04-19T22:31:48.742731",
    "serverPathVersion": "v1"
  }
}

GET /api/v1/s3/presign-url?rootPath=images&uploadSize=1&contentType=image%2Fjpeg HTTP/1.1
Host: api.bottle-note.com

{
  "success" : true,
  "code" : 200,
  "data" : {
    "bucketName" : "image-bucket",
    "uploadSize" : 1,
    "expiryTime" : 5,
    "imageUploadInfo" : [ {
      "order" : 1,
      "viewUrl" : "https://d1d1d1d1.cloudfront.net/images/1",
      "uploadUrl" : "https://bottlenote.s3.ap-northeast-2.amazonaws.com/images/1"
    } ]
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 12, 342901447 ],
    "serverPathVersion" : "v1"
  }
}

GET /api/v2/auth/apple/nonce

$ curl 'https://api.bottle-note.com/api/v2/auth/apple/nonce?_csrf=KNfV8gRYUwEetm0-x7tcRaIa_1teJXZKFixWdw7kZOJwLrL7Tua3wGE7MmQz0wlao5ZoJ8Aj0mNqRhVnJhxnETfTXYRJS4XM' -i -X GET \
    -H 'Content-Type: application/json;charset=UTF-8'

GET /api/v2/auth/apple/nonce?_csrf=KNfV8gRYUwEetm0-x7tcRaIa_1teJXZKFixWdw7kZOJwLrL7Tua3wGE7MmQz0wlao5ZoJ8Aj0mNqRhVnJhxnETfTXYRJS4XM HTTP/1.1
Content-Type: application/json;charset=UTF-8
Host: api.bottle-note.com

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 32

{
  "nonce" : "test-nonce-123"
}

POST /api/v2/auth/apple

$ curl 'https://api.bottle-note.com/api/v2/auth/apple?_csrf=zvqsDR6C_tDzMe8Dr5Ni0fPXadh_Unn-r10vxANatA17aj8HrMmaOCawx-XeV9lin75W48rnRLobMRzTzG4d_WZq1jRLXQk-' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "idToken" : "test-id-token",
  "nonce" : "test-nonce"
}'

POST /api/v2/auth/apple?_csrf=zvqsDR6C_tDzMe8Dr5Ni0fPXadh_Unn-r10vxANatA17aj8HrMmaOCawx-XeV9lin75W48rnRLobMRzTzG4d_WZq1jRLXQk- HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 59
Host: api.bottle-note.com

{
  "idToken" : "test-id-token",
  "nonce" : "test-nonce"
}

HTTP/1.1 200 OK
Set-Cookie: refresh-token=test-refresh-token; Path=/; Max-Age=0; Expires=Thu, 01 Jan 1970 00:00:00 GMT; Secure; HttpOnly
Content-Type: application/json;charset=UTF-8
Content-Length: 107

{
  "accessToken" : "test-access-token",
  "isFirstLogin" : true,
  "nickname" : "부드러운몰트1234"
}

POST /api/v2/auth/kakao

$ curl 'https://api.bottle-note.com/api/v2/auth/kakao?_csrf=TohBpWz2jHuFuwAjIPyVAUqwSRqn1oUd9HFTr3CApeTmtIfYdrkknAiSvR2ojGQQFNGhMXqGZCKW5rcwkRI3zBa1x9eE0ePq' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "accessToken" : "test-kakao-access-token"
}'

POST /api/v2/auth/kakao?_csrf=TohBpWz2jHuFuwAjIPyVAUqwSRqn1oUd9HFTr3CApeTmtIfYdrkknAiSvR2ojGQQFNGhMXqGZCKW5rcwkRI3zBa1x9eE0ePq HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 47
Host: api.bottle-note.com

{
  "accessToken" : "test-kakao-access-token"
}

HTTP/1.1 200 OK
Set-Cookie: refresh-token=test-refresh-token; Path=/; Max-Age=0; Expires=Thu, 01 Jan 1970 00:00:00 GMT; Secure; HttpOnly
Content-Type: application/json;charset=UTF-8
Content-Length: 107

{
  "accessToken" : "test-access-token",
  "isFirstLogin" : true,
  "nickname" : "부드러운몰트1234"
}

GET /api/v2/auth/admin/permissions

$ curl 'https://api.bottle-note.com/api/v2/auth/admin/permissions?_csrf=uACQ097h6K0Ic2G-NBSo0No4Zdd2sEDFeAyGNDhPRK0CKCDyiDSht-vW2MglRVWPBTmcsu4BSLZOh3HoT2rlUVsuJp1gTRXA' -i -X GET \
    -H 'Content-Type: application/json;charset=UTF-8'

GET /api/v2/auth/admin/permissions?_csrf=uACQ097h6K0Ic2G-NBSo0No4Zdd2sEDFeAyGNDhPRK0CKCDyiDSht-vW2MglRVWPBTmcsu4BSLZOh3HoT2rlUVsuJp1gTRXA HTTP/1.1
Content-Type: application/json;charset=UTF-8
Host: api.bottle-note.com

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 251

{
  "success" : true,
  "code" : 200,
  "data" : true,
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 12, 824160578 ],
    "serverPathVersion" : "v1"
  }
}

POST /api/v1/oauth/login

{
  "email" : "cdm2883@naver.com",
  "socialUniqueId" : "",
  "socialType" : "KAKAO",
  "gender" : "MALE",
  "age" : 27
}

HTTP/1.1 200 OK
Set-Cookie: refresh-token=eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJn44WB44WBZ2dAbmF2ZXIuY29tIiwicm9sZXMiOiJST0xFX1VTRVIiLCJ1c2VySWQiOjE2LCJpYXQiOjE3MTQ5NzU2MjMsImV4cCI6MTcxNjE4NTIyM30.lvmPueUcOb1erv5Llo4qhEUQ_gtWrpFGbBHDw-Pi94qj8MGojoEI3ugdMo8PwoKgrVQZ_gBwBbytwjxh8XktUg; Path=/; Max-Age=1209600; Expires=Wed, 22 Apr 2026 13:53:13 GMT; Secure; HttpOnly
Content-Type: application/json;charset=UTF-8
Content-Length: 560

{
  "success" : true,
  "code" : 200,
  "data" : {
    "accessToken" : "eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJn44WB44WBZ2dAbmF2ZXIuY29tIiwicm9sZXMiOiJST0xFX1VTRVIiLCJ1c2VySWQiOjE2LCJpYXQiOjE3MTQ5NzU2MjMsImV4cCI6MTcxNDk3NjUyM30.41SuOBgmX-sd8nrMbC-xm0kH6rbny_SMYCKWE4rNQEZgSrRPS0HvYv0X7E-weo6sHlWWm1OmiQgHl4-uy6-9ig",
    "isFirstLogin" : null,
    "nickname" : null
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 13, 400701337 ],
    "serverPathVersion" : "v1"
  }
}

POST /api/v1/oauth/basic/signup

$ curl 'https://api.bottle-note.com/api/v1/oauth/basic/signup?_csrf=kBUc6KpG-SrvtYAeRpRtwI0Dz1brKD_W_0jsGm1rCksu-mgtoSJ_jMhxyknCjLcqJblZ8LRi4m_cGQj7yXCKLQsJPHwcyVxM' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "email" : "test@email.com",
  "password" : "test-password",
  "age" : 27,
  "gender" : null
}'

{
  "email" : "test@email.com",
  "password" : "test-password",
  "age" : 27,
  "gender" : null
}

{
  "success" : true,
  "code" : 200,
  "data" : {
    "message" : "부드러운몰트님 환영합니다!",
    "email" : "test@email.com",
    "nickname" : "부드러운몰트",
    "accessToken" : "access-token",
    "refreshToken" : "refresh-token"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 13, 353453435 ],
    "serverPathVersion" : "v1"
  }
}

POST /api/v1/oauth/basic/login

$ curl 'https://api.bottle-note.com/api/v1/oauth/basic/login?_csrf=NdjREKZFBr5gg-InPB6wc01eCXtL6jPaDg8yxWzrGN-GMvChBOjnJ8V2Z9hN5YAWBTOERStqJBp7iQL3OmoF_V3bee2_A8LA' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "email" : "test@email.com",
  "password" : "test-password"
}'

{
  "email" : "test@email.com",
  "password" : "test-password"
}

{
  "success" : true,
  "code" : 200,
  "data" : {
    "accessToken" : "access-token",
    "isFirstLogin" : null,
    "nickname" : null
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 13, 425512373 ],
    "serverPathVersion" : "v1"
  }
}

POST /api/v1/oauth/reissue

HTTP/1.1 200 OK
Set-Cookie: refresh-token=new-refresh-token; Path=/; Max-Age=1209600; Expires=Wed, 22 Apr 2026 13:53:13 GMT; Secure; HttpOnly
Content-Type: application/json;charset=UTF-8
Content-Length: 341

{
  "success" : true,
  "code" : 200,
  "data" : {
    "accessToken" : "new-access-token",
    "isFirstLogin" : null,
    "nickname" : null
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 13, 325834288 ],
    "serverPathVersion" : "v1"
  }
}

PATCH /api/v1/users/nickname

{
  "nickName" : "newNickname"
}

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 419

{
  "success" : true,
  "code" : 200,
  "data" : {
    "message" : "닉네임이 성공적으로 변경되었습니다.",
    "userId" : 1,
    "beforeNickname" : "beforeNickname",
    "changedNickname" : "newNickname"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 13, 14430000 ],
    "serverPathVersion" : "v1"
  }
}

PATCH /api/v1/users/profile-image

PATCH /api/v1/users/profile-image?_csrf=iFrV_B-b0-cjJvw5uuWTnRVRoKYiOkp3X4FD3l6X-bm8zvA3vG-0ySv45oMOEs4M3sinqyBkjZ8aWS9aaeJw7W-vzoCE-sAB HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 69
Host: api.bottle-note.com

{
  "viewUrl" : "https://api.bottle-note.com/new-profile-image.jpg"
}

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 395

{
  "success" : true,
  "code" : 200,
  "data" : {
    "userId" : 1,
    "profileImageUrl" : "http://example.com/new-profile-image.jpg",
    "callback" : "https://bottle-note.com/api/v1/users/1"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 13, 39084323 ],
    "serverPathVersion" : "v1"
  }
}

PATCH /api/v1/users/current

$ curl 'https://api.bottle-note.com/api/v1/users/current?_csrf=JCLDaY9cI09-4j8XZp2ifoW9y5yH9sAuQSuxPdFlwU2Mt4eDHBKnX7hpEnxT2g4lUrCWG7GP5qSzzqQDcBjTX7UEonS91bDn' -i -X GET \
    -H 'Content-Type: application/json;charset=UTF-8'

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 355

{
  "success" : true,
  "code" : 200,
  "data" : {
    "id" : 1,
    "nickname" : "로그인한_유저_닉네임",
    "imageUrl" : "없을수도 잇음"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 13, 518992248 ],
    "serverPathVersion" : "v1"
  }
}

DELETE /api/v1/users

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 423

{
  "success" : true,
  "code" : 200,
  "data" : {
    "codeMessage" : "USER_WITHDRAW_SUCCESS",
    "message" : "성공적으로 탈퇴가 완료되었습니다",
    "userId" : 1,
    "responseAt" : "2026-04-08 13:53:13"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 13, 540370865 ],
    "serverPathVersion" : "v1"
  }
}

POST /api/v1/oauth/restore

$ curl 'https://api.bottle-note.com/api/v1/oauth/restore?_csrf=ZlBxqVLD3vNao6FqIHYdFADRekeOVvF-gEJ5F29VwxfWGCnWA2hCmjP65sJ3lpdeFlspcWXiV3-2ZMBTuXtLIgplpXW0KR-3' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "email" : "test-email",
  "password" : "test-password"
}'

POST /api/v1/oauth/restore?_csrf=ZlBxqVLD3vNao6FqIHYdFADRekeOVvF-gEJ5F29VwxfWGCnWA2hCmjP65sJ3lpdeFlspcWXiV3-2ZMBTuXtLIgplpXW0KR-3 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 60
Host: api.bottle-note.com

{
  "email" : "test-email",
  "password" : "test-password"
}

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 264

{
  "success" : true,
  "code" : 200,
  "data" : "restore success",
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 13, 464323739 ],
    "serverPathVersion" : "v1"
  }
}

GET /api/mypage/{userId}

$ curl 'https://api.bottle-note.com/api/v1/my-page/1?_csrf=m95ETQl9iWPoA5zdq-c6SrwnABmuYXQE9ypLT64xkxMcGQUso-khLjFOu1rFM67km8oOed1DLSCdUhIpwExzeZYA9XJ_LTRN' -i -X GET \
    -H 'Content-Type: application/json;charset=UTF-8'

{
  "success" : true,
  "code" : 200,
  "data" : {
    "userId" : 1,
    "nickName" : "nickname",
    "imageUrl" : "imageUrl",
    "reviewCount" : 10,
    "ratingCount" : 20,
    "pickCount" : 30,
    "followerCount" : 40,
    "followingCount" : 50,
    "isFollow" : false,
    "isMyPage" : false
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 13, 65821150 ],
    "serverPathVersion" : "v1"
  }
}

---
GET /api/v1/mypage/{userId}/my-bottle/reviews
---

---
GET /api/v1/mypage/{userId}/my-bottle/ratings
---

---
GET /api/v1/mypage/{userId}/my-bottle/picks
---

POST /api/v1/push/token

{
  "deviceToken" : "3c759897-3a3c-46fa-972e-8db381ea5bcb",
  "platform" : "IOS"
}

{
  "success" : true,
  "code" : 200,
  "data" : {
    "deviceToken" : "3c759897-3a3c-46fa-972e-8db381ea5bcb",
    "platform" : "IOS",
    "message" : "DEVICE_TOKEN_SAVED"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 13, 688841535 ],
    "serverPathVersion" : "v1"
  }
}

GET /api/v1/banners?limit={limit}

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "id" : 1,
    "name" : "신규 위스키 출시 이벤트",
    "nameFontColor" : "ffffff",
    "descriptionA" : "신규 위스키 출시 기념",
    "descriptionB" : "특별 이벤트를 진행합니다.",
    "descriptionFontColor" : "ffffff",
    "imageUrl" : "https://cdn.bottle-note.com/banners/event1.jpg",
    "textPosition" : "LB",
    "targetUrl" : "/events/new-whiskey",
    "isExternalUrl" : false,
    "mediaType" : "IMAGE",
    "bannerType" : "CURATION",
    "sortOrder" : 0,
    "startDate" : [ 2025, 1, 1, 0, 0 ],
    "endDate" : [ 2025, 12, 31, 23, 59 ]
  }, {
    "id" : 2,
    "name" : "사용자 설문조사",
    "nameFontColor" : "ffffff",
    "descriptionA" : "서비스 개선을 위한",
    "descriptionB" : "설문조사에 참여해주세요.",
    "descriptionFontColor" : "ffffff",
    "imageUrl" : "https://cdn.bottle-note.com/banners/survey.jpg",
    "textPosition" : "CENTER",
    "targetUrl" : "https://forms.google.com/survey123",
    "isExternalUrl" : true,
    "mediaType" : "IMAGE",
    "bannerType" : "SURVEY",
    "sortOrder" : 1,
    "startDate" : [ 2025, 6, 1, 0, 0 ],
    "endDate" : [ 2025, 6, 30, 23, 59 ]
  }, {
    "id" : 3,
    "name" : "제휴 브랜드 소개",
    "nameFontColor" : "ffffff",
    "descriptionA" : "새로운 제휴 브랜드를",
    "descriptionB" : "소개합니다.",
    "descriptionFontColor" : "ffffff",
    "imageUrl" : "https://cdn.bottle-note.com/banners/partner.jpg",
    "textPosition" : "RT",
    "targetUrl" : "/partners/brand-abc",
    "isExternalUrl" : false,
    "mediaType" : "VIDEO",
    "bannerType" : "PARTNERSHIP",
    "sortOrder" : 2,
    "startDate" : null,
    "endDate" : null
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 9, 682584333 ],
    "serverPathVersion" : "v1"
  }
}

if (banner.isExternalUrl) {
    // 외부 브라우저 또는 인앱 웹뷰로 열기
    openExternalBrowser(banner.targetUrl)
} else {
    // 앱 내부 화면으로 이동
    navigateToInternalRoute(banner.targetUrl)
}

keywords="keyword1"&keywords="keyword2"
- 형태로 여러 키워드를 입력할 수 있다.

$ curl 'https://api.bottle-note.com/api/v1/alcohols/explore/standard?keywords=keyword1&keywords=keyword2&cursor=0&size=10' -i -X GET

GET /api/v1/alcohols/explore/standard?keywords=keyword1&keywords=keyword2&cursor=0&size=10 HTTP/1.1
Host: api.bottle-note.com

{
  "success" : true,
  "code" : 200,
  "data" : {
    "totalCount" : 500,
    "items" : [ {
      "alcoholId" : 73,
      "alcoholUrlImg" : "https://static.whiskybase.com/storage/whiskies/73/404573-big.jpg",
      "korName" : "글렌리벳 17년 블렌디드 위스키",
      "engName" : "Glenlivet 17 Years Blended",
      "korCategory" : "싱글 몰트",
      "engCategory" : "Single Malt",
      "korRegion" : "스코틀랜드/하이랜드",
      "engRegion" : "Scotland/Highlands",
      "cask" : "Pedro Ximenez Sherry Casks",
      "abv" : "51",
      "korDistillery" : "글렌리벳 디스틸러리",
      "engDistillery" : "Glenlivet Distillery",
      "rating" : 3.5,
      "totalRatingsCount" : 457,
      "myRating" : 1.0,
      "myAvgRating" : 2.5,
      "isPicked" : false,
      "alcoholsTastingTags" : [ "과일향", "오크향", "꿀향", "초콜릿", "향긋한" ]
    }, {
      "alcoholId" : 63,
      "alcoholUrlImg" : "https://static.whiskybase.com/storage/whiskies/63/404563-big.jpg",
      "korName" : "발베니 17년 시그니처 위스키",
      "engName" : "Balvenie 17 Years Signature",
      "korCategory" : "싱글 몰트",
      "engCategory" : "Single Malt",
      "korRegion" : "스코틀랜드/하이랜드",
      "engRegion" : "Scotland/Highlands",
      "cask" : "Pedro Ximenez Sherry Casks",
      "abv" : "40",
      "korDistillery" : "발베니 디스틸러리",
      "engDistillery" : "Balvenie Distillery",
      "rating" : 3.5,
      "totalRatingsCount" : 155,
      "myRating" : 1.0,
      "myAvgRating" : 4.0,
      "isPicked" : false,
      "alcoholsTastingTags" : [ "시트러스", "부드러운", "향긋한", "바닐라" ]
    }, {
      "alcoholId" : 95,
      "alcoholUrlImg" : "https://static.whiskybase.com/storage/whiskies/95/404595-big.jpg",
      "korName" : "글렌피딕 17년 싱글몰트 위스키",
      "engName" : "Glenfiddich 17 Years Single Malt",
      "korCategory" : "싱글 몰트",
      "engCategory" : "Single Malt",
      "korRegion" : "스코틀랜드/하이랜드",
      "engRegion" : "Scotland/Highlands",
      "cask" : "Pedro Ximenez Sherry Casks",
      "abv" : "41",
      "korDistillery" : "글렌피딕 디스틸러리",
      "engDistillery" : "Glenfiddich Distillery",
      "rating" : 3.5,
      "totalRatingsCount" : 991,
      "myRating" : 3.5,
      "myAvgRating" : 0.5,
      "isPicked" : false,
      "alcoholsTastingTags" : [ "피트향", "달달한" ]
    } ]
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 8, 302090818 ],
    "pageable" : {
      "currentCursor" : 0,
      "cursor" : 0,
      "pageSize" : 10,
      "hasNext" : true
    },
    "searchParameters" : {
      "keywords" : [ "keyword1", "keyword2" ]
    },
    "serverPathVersion" : "v1"
  }
}

keywords="keyword1"&keywords="keyword2"
- 형태로 여러 키워드를 입력할 수 있다.

$ curl 'https://api.bottle-note.com/api/v1/reviews/explore/standard?keywords=%ED%82%A4%EC%9B%8C%EB%93%9C1&keywords=%ED%82%A4%EC%9B%8C%EB%93%9C2&cursor=0&size=20' -i -X GET

GET /api/v1/reviews/explore/standard?keywords=%ED%82%A4%EC%9B%8C%EB%93%9C1&keywords=%ED%82%A4%EC%9B%8C%EB%93%9C2&cursor=0&size=20 HTTP/1.1
Host: api.bottle-note.com

{
  "success" : true,
  "code" : 200,
  "data" : {
    "totalCount" : 500,
    "items" : [ {
      "userInfo" : {
        "userId" : 1,
        "nickName" : "사용자1",
        "userProfileImage" : "https://example.com/profile1.jpg"
      },
      "isMyReview" : true,
      "alcoholId" : 101,
      "alcoholName" : "시그넷 위스키 1",
      "reviewId" : 1001,
      "reviewContent" : "이 위스키는 정말 맛있습니다. 과일향과 오크향이 절묘하게 어우러져 있어요. 1",
      "reviewRating" : 4.6,
      "reviewTags" : [ "달달한", "과일향", "오크향" ],
      "createAt" : [ 2026, 4, 7, 13, 53, 11, 51120519 ],
      "modifiedAt" : [ 2026, 4, 8, 12, 53, 11, 51135787 ],
      "totalImageCount" : 2,
      "reviewImages" : [ "https://example.com/image1_1.jpg", "https://example.com/image1_2.jpg" ],
      "isBestReview" : false,
      "likeCount" : 10,
      "isLikedByMe" : false,
      "replyCount" : 5,
      "hasReplyByMe" : true
    }, {
      "userInfo" : {
        "userId" : 2,
        "nickName" : "사용자2",
        "userProfileImage" : "https://example.com/profile2.jpg"
      },
      "isMyReview" : false,
      "alcoholId" : 102,
      "alcoholName" : "시그넷 위스키 2",
      "reviewId" : 1002,
      "reviewContent" : "이 위스키는 정말 맛있습니다. 과일향과 오크향이 절묘하게 어우러져 있어요. 2",
      "reviewRating" : 4.7,
      "reviewTags" : [ "달달한", "과일향", "오크향" ],
      "createAt" : [ 2026, 4, 6, 13, 53, 11, 51186442 ],
      "modifiedAt" : [ 2026, 4, 8, 11, 53, 11, 51194096 ],
      "totalImageCount" : 2,
      "reviewImages" : [ "https://example.com/image2_1.jpg", "https://example.com/image2_2.jpg" ],
      "isBestReview" : true,
      "likeCount" : 20,
      "isLikedByMe" : false,
      "replyCount" : 10,
      "hasReplyByMe" : false
    }, {
      "userInfo" : {
        "userId" : 3,
        "nickName" : "사용자3",
        "userProfileImage" : "https://example.com/profile3.jpg"
      },
      "isMyReview" : false,
      "alcoholId" : 103,
      "alcoholName" : "시그넷 위스키 3",
      "reviewId" : 1003,
      "reviewContent" : "이 위스키는 정말 맛있습니다. 과일향과 오크향이 절묘하게 어우러져 있어요. 3",
      "reviewRating" : 4.8,
      "reviewTags" : [ "달달한", "과일향", "오크향" ],
      "createAt" : [ 2026, 4, 5, 13, 53, 11, 51229553 ],
      "modifiedAt" : [ 2026, 4, 8, 10, 53, 11, 51236095 ],
      "totalImageCount" : 2,
      "reviewImages" : [ "https://example.com/image3_1.jpg", "https://example.com/image3_2.jpg" ],
      "isBestReview" : false,
      "likeCount" : 30,
      "isLikedByMe" : true,
      "replyCount" : 15,
      "hasReplyByMe" : false
    } ]
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 11, 54412745 ],
    "pageable" : {
      "currentCursor" : 0,
      "cursor" : 20,
      "pageSize" : 20,
      "hasNext" : true
    },
    "searchParameters" : {
      "keywords" : [ "키워드1", "키워드2" ]
    },
    "serverPathVersion" : "v1"
  }
}

$ http GET 'https://api.bottle-note.com/api/v1/alcohols/search?keyword=glen&category=SINGLE_MALT&regionId=1&sortType=REVIEW&sortOrder=DESC&cursor=0&pageSize=3'

{
  "success" : true,
  "code" : 200,
  "data" : {
    "totalCount" : 5,
    "alcohols" : [ {
      "alcoholId" : 5,
      "korName" : "아녹 24년",
      "engName" : "anCnoc 24-year-old",
      "korCategoryName" : "싱글 몰트",
      "engCategoryName" : "Single Malt",
      "imageUrl" : "https://static.whiskybase.com/storage/whiskies/6/6/989/270671-big.jpg",
      "rating" : 4.5,
      "ratingCount" : 1,
      "reviewCount" : 0,
      "pickCount" : 1,
      "isPicked" : false
    }, {
      "alcoholId" : 1,
      "korName" : "글래스고 1770 싱글몰트 스카치 위스키",
      "engName" : "1770 Glasgow Single Malt",
      "korCategoryName" : "싱글 몰트",
      "engCategoryName" : "Single Malt",
      "imageUrl" : "https://static.whiskybase.com/storage/whiskies/2/0/8916/404538-big.jpg",
      "rating" : 3.5,
      "ratingCount" : 3,
      "reviewCount" : 1,
      "pickCount" : 1,
      "isPicked" : true
    }, {
      "alcoholId" : 2,
      "korName" : "글래스고 1770 싱글몰트 스카치 위스키",
      "engName" : "1770 Glasgow Single Malt",
      "korCategoryName" : "싱글 몰트",
      "engCategoryName" : "Single Malt",
      "imageUrl" : "https://static.whiskybase.com/storage/whiskies/2/0/8888/404535-big.jpg",
      "rating" : 3.5,
      "ratingCount" : 1,
      "reviewCount" : 0,
      "pickCount" : 1,
      "isPicked" : true
    } ]
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 8, 807473955 ],
    "pageable" : {
      "currentCursor" : 0,
      "cursor" : 4,
      "pageSize" : 3,
      "hasNext" : true
    },
    "searchParameters" : {
      "keyword" : "glen",
      "curationId" : null,
      "category" : "SINGLE_MALT",
      "regionId" : 1,
      "sortType" : "REVIEW",
      "sortOrder" : "DESC",
      "cursor" : 0,
      "pageSize" : 3
    },
    "serverPathVersion" : "v1"
  }
}

GET /api/v1/alcohols/{alcoholsId}

{
  "success" : true,
  "code" : 200,
  "data" : {
    "alcohols" : {
      "alcoholId" : 42,
      "alcoholUrlImg" : "https://static.whiskybase.com/storage/whiskies/42/404542-big.jpg",
      "korName" : "글렌피딕 20년 더블 캐스크 위스키",
      "engName" : "Glenfiddich 20 Years Double Cask",
      "korCategory" : "싱글 몰트",
      "engCategory" : "Single Malt",
      "korRegion" : "스코틀랜드/하이랜드",
      "engRegion" : "Scotland/Highlands",
      "cask" : "Ex-Bourbon Casks",
      "abv" : "42",
      "korDistillery" : "글렌피딕 디스틸러리",
      "engDistillery" : "Glenfiddich Distillery",
      "rating" : 3.5,
      "totalRatingsCount" : 778,
      "myRating" : 5.0,
      "myAvgRating" : 2.0,
      "isPicked" : true,
      "alcoholsTastingTags" : [ "달달한", "바닐라", "후추향의" ]
    },
    "friendsInfo" : {
      "followerCount" : 6,
      "friends" : [ {
        "userImageUrl" : "https://picsum.photos/600/600",
        "userId" : 1,
        "nickName" : "늙은코끼리",
        "rating" : 4.5
      }, {
        "userImageUrl" : "https://picsum.photos/600/600",
        "userId" : 2,
        "nickName" : "나무사자",
        "rating" : 1.5
      }, {
        "userImageUrl" : "https://picsum.photos/600/600",
        "userId" : 3,
        "nickName" : "피자파인애플",
        "rating" : 3.0
      }, {
        "userImageUrl" : "https://picsum.photos/600/600",
        "userId" : 4,
        "nickName" : "멘토스",
        "rating" : 0.5
      }, {
        "userImageUrl" : "https://picsum.photos/600/600",
        "userId" : 5,
        "nickName" : "민트맛치토스",
        "rating" : 5.0
      }, {
        "userImageUrl" : "https://picsum.photos/600/600",
        "userId" : 6,
        "nickName" : "목데이터",
        "rating" : 1.0
      } ]
    },
    "reviewInfo" : {
      "totalCount" : 2,
      "reviewList" : [ {
        "reviewId" : 0,
        "reviewContent" : "좋은 리뷰입니다 (qCxdGFQlqb)",
        "reviewImageUrl" : "https://example.com/review-image.jpg",
        "createAt" : [ 2026, 4, 8, 13, 53, 8, 912395776 ],
        "totalImageCount" : null,
        "userInfo" : {
          "userId" : 1,
          "nickName" : "홍길동",
          "userProfileImage" : "https://example.com/profile.jpg"
        },
        "isMyReview" : true,
        "status" : "PUBLIC",
        "isBestReview" : false,
        "locationInfo" : {
          "name" : "도시술",
          "zipCode" : null,
          "address" : "서울 송파구 송파대로 145",
          "detailAddress" : "2층 도시술",
          "category" : "음식점 > 술집 > 칵테일바",
          "mapUrl" : "https://place.map.kakao.com/2088591613",
          "latitude" : "37.4835934678036",
          "longitude" : "127.122831408454"
        },
        "sizeType" : "BOTTLE",
        "price" : 100000,
        "rating" : 4.5,
        "likeCount" : 10,
        "replyCount" : 2,
        "isLikedByMe" : false,
        "hasReplyByMe" : true,
        "viewCount" : 0,
        "tastingTagList" : [ "과일향", "부드러움" ]
      }, {
        "reviewId" : 1,
        "reviewContent" : "좋은 리뷰입니다 (wiOpzrTmFJ)",
        "reviewImageUrl" : "https://example.com/review-image.jpg",
        "createAt" : [ 2026, 4, 8, 13, 53, 8, 912467059 ],
        "totalImageCount" : null,
        "userInfo" : {
          "userId" : 1,
          "nickName" : "홍길동",
          "userProfileImage" : "https://example.com/profile.jpg"
        },
        "isMyReview" : true,
        "status" : "PUBLIC",
        "isBestReview" : false,
        "locationInfo" : {
          "name" : "도시술",
          "zipCode" : null,
          "address" : "서울 송파구 송파대로 145",
          "detailAddress" : "2층 도시술",
          "category" : "음식점 > 술집 > 칵테일바",
          "mapUrl" : "https://place.map.kakao.com/2088591613",
          "latitude" : "37.4835934678036",
          "longitude" : "127.122831408454"
        },
        "sizeType" : "BOTTLE",
        "price" : 100000,
        "rating" : 4.5,
        "likeCount" : 10,
        "replyCount" : 2,
        "isLikedByMe" : false,
        "hasReplyByMe" : true,
        "viewCount" : 0,
        "tastingTagList" : [ "과일향", "부드러움" ]
      } ]
    }
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 8, 914952266 ],
    "serverPathVersion" : "v1"
  }
}

PUT apv/v1/picks

{
  "alcoholId" : 1,
  "isPicked" : "PICK"
}

{
  "success" : true,
  "code" : 200,
  "data" : {
    "message" : "정상적으로 찜하기 처리 되었습니다.",
    "status" : "PICK"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 10, 344285923 ],
    "serverPathVersion" : "v1"
  }
}

GET /api/v1/regions

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "regionId" : 1,
    "korName" : "스코틀랜드/로우랜드",
    "engName" : "Scotland/Lowlands",
    "description" : "가벼운 맛이 특징인 로우랜드 위스키",
    "parentId" : 19
  }, {
    "regionId" : 2,
    "korName" : "스코틀랜드/하이랜드",
    "engName" : "Scotland/Highlands",
    "description" : "맛의 다양성이 특징인 하이랜드 위스키, 해안의 짠맛부터 달콤하고 과일 맛까지",
    "parentId" : 19
  }, {
    "regionId" : 3,
    "korName" : "스코틀랜드/아일랜드",
    "engName" : "Scotland/Ireland",
    "description" : "부드러운 맛이 특징인 아일랜드 위스키",
    "parentId" : 19
  }, {
    "regionId" : 11,
    "korName" : "프랑스",
    "engName" : "France",
    "description" : "주로 브랜디와 와인 생산지로 유명하지만 위스키도 생산",
    "parentId" : null
  }, {
    "regionId" : 12,
    "korName" : "스웨덴",
    "engName" : "Sweden",
    "description" : "실험적인 방법으로 만드는 스웨덴 위스키",
    "parentId" : null
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 9, 496791253 ],
    "serverPathVersion" : "v1"
  }
}

GET /api/v1/alcohols/categories?type=WHISKY HTTP/1.1
Host: api.bottle-note.com

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "korCategory" : "SINGLE_MOLT",
    "engCategory" : "싱글 몰트",
    "categoryGroup" : "SINGLE_MALT"
  }, {
    "korCategory" : "BLENDED",
    "engCategory" : "블렌디드",
    "categoryGroup" : "BLEND"
  }, {
    "korCategory" : "BOURBON",
    "engCategory" : "버번",
    "categoryGroup" : "BOURBON"
  }, {
    "korCategory" : "RYE",
    "engCategory" : "라이",
    "categoryGroup" : "RYE"
  }, {
    "korCategory" : "OTHER",
    "engCategory" : "기타",
    "categoryGroup" : "OTHER"
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 9, 532099765 ],
    "serverPathVersion" : "v1"
  }
}

GET /api/v1/curations

{
  "success" : true,
  "code" : 200,
  "data" : {
    "items" : [ {
      "id" : 1,
      "name" : "봄 추천 위스키",
      "description" : "봄에 어울리는 위스키 모음",
      "coverImageUrl" : "https://example.com/spring-whisky.jpg",
      "alcoholCount" : 10,
      "displayOrder" : 1
    }, {
      "id" : 2,
      "name" : "여름 추천 위스키",
      "description" : "여름에 어울리는 위스키 모음",
      "coverImageUrl" : "https://example.com/summer-whisky.jpg",
      "alcoholCount" : 8,
      "displayOrder" : 2
    } ],
    "pageable" : {
      "currentCursor" : 0,
      "cursor" : 10,
      "pageSize" : 10,
      "hasNext" : false
    }
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 9, 150945785 ],
    "serverPathVersion" : "v1"
  }
}

GET /api/v1/curations/{curationId}/alcohols

{
  "success" : true,
  "code" : 200,
  "data" : {
    "items" : [ {
      "alcoholId" : 1,
      "korName" : "글렌피딕 15년",
      "engName" : "Glenfiddich 15",
      "korCategoryName" : "싱글 몰트",
      "engCategoryName" : "Single Malt",
      "imageUrl" : "https://example.com/image.jpg",
      "rating" : 4.5,
      "ratingCount" : 100,
      "reviewCount" : 50,
      "pickCount" : 30,
      "isPicked" : false
    } ],
    "pageable" : {
      "currentCursor" : 0,
      "cursor" : 10,
      "pageSize" : 10,
      "hasNext" : false
    }
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 9, 215090518 ],
    "serverPathVersion" : "v1"
  }
}

GET /api/v1/curations/1/alcohols?cursor=0&pageSize=10

GET /api/v1/popular/week

{
  "success" : true,
  "code" : 200,
  "data" : {
    "totalCount" : 5,
    "alcohols" : [ {
      "alcoholId" : 1,
      "korName" : "글렌피딕",
      "engName" : "Glenfiddich",
      "rating" : 1.0,
      "ratingCount" : 56,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : false,
      "popularScore" : 0.01
    }, {
      "alcoholId" : 2,
      "korName" : "맥캘란",
      "engName" : "Macallan",
      "rating" : 0.5,
      "ratingCount" : 9,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : true,
      "popularScore" : 0.0
    }, {
      "alcoholId" : 3,
      "korName" : "글렌리벳",
      "engName" : "Glenlivet",
      "rating" : 2.5,
      "ratingCount" : 4,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : false,
      "popularScore" : 0.01
    }, {
      "alcoholId" : 4,
      "korName" : "발베니",
      "engName" : "Balvenie",
      "rating" : 2.0,
      "ratingCount" : 57,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : true,
      "popularScore" : 0.0
    }, {
      "alcoholId" : 5,
      "korName" : "라프로익",
      "engName" : "Laphroaig",
      "rating" : 1.0,
      "ratingCount" : 85,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : false,
      "popularScore" : 0.0
    } ]
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 9, 454730454 ],
    "serverPathVersion" : "v1"
  }
}

GET /api/v1/popular/spring

$ curl 'https://api.bottle-note.com/api/v1/popular/spring' -i -X GET

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "alcoholId" : 1,
    "korName" : "글렌피딕",
    "engName" : "Glenfiddich",
    "rating" : 0.5,
    "ratingCount" : 85,
    "korCategory" : "싱글 몰트",
    "engCategory" : "single molt",
    "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
    "isPicked" : false,
    "popularScore" : 0.01
  }, {
    "alcoholId" : 2,
    "korName" : "맥캘란",
    "engName" : "Macallan",
    "rating" : 1.5,
    "ratingCount" : 81,
    "korCategory" : "싱글 몰트",
    "engCategory" : "single molt",
    "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
    "isPicked" : true,
    "popularScore" : 0.0
  }, {
    "alcoholId" : 3,
    "korName" : "글렌리벳",
    "engName" : "Glenlivet",
    "rating" : 0.0,
    "ratingCount" : 63,
    "korCategory" : "싱글 몰트",
    "engCategory" : "single molt",
    "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
    "isPicked" : false,
    "popularScore" : 0.0
  }, {
    "alcoholId" : 4,
    "korName" : "발베니",
    "engName" : "Balvenie",
    "rating" : 2.0,
    "ratingCount" : 80,
    "korCategory" : "싱글 몰트",
    "engCategory" : "single molt",
    "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
    "isPicked" : true,
    "popularScore" : 0.0
  }, {
    "alcoholId" : 5,
    "korName" : "라프로익",
    "engName" : "Laphroaig",
    "rating" : 0.0,
    "ratingCount" : 92,
    "korCategory" : "싱글 몰트",
    "engCategory" : "single molt",
    "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
    "isPicked" : false,
    "popularScore" : 0.0
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 9, 415019991 ],
    "serverPathVersion" : "v1"
  }
}

GET /api/v1/popular/view/week

{
  "success" : true,
  "code" : 200,
  "data" : {
    "totalCount" : 5,
    "alcohols" : [ {
      "alcoholId" : 1,
      "korName" : "글렌피딕",
      "engName" : "Glenfiddich",
      "rating" : 1.0,
      "ratingCount" : 34,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : false,
      "popularScore" : 0.01
    }, {
      "alcoholId" : 2,
      "korName" : "맥캘란",
      "engName" : "Macallan",
      "rating" : 0.0,
      "ratingCount" : 55,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : true,
      "popularScore" : 0.0
    }, {
      "alcoholId" : 3,
      "korName" : "글렌리벳",
      "engName" : "Glenlivet",
      "rating" : 1.5,
      "ratingCount" : 92,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : false,
      "popularScore" : 0.0
    }, {
      "alcoholId" : 4,
      "korName" : "발베니",
      "engName" : "Balvenie",
      "rating" : 2.0,
      "ratingCount" : 48,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : true,
      "popularScore" : 0.01
    }, {
      "alcoholId" : 5,
      "korName" : "라프로익",
      "engName" : "Laphroaig",
      "rating" : 1.5,
      "ratingCount" : 64,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : false,
      "popularScore" : 0.01
    } ]
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 9, 312404823 ],
    "serverPathVersion" : "v1"
  }
}

GET /api/v1/popular/view/monthly

{
  "success" : true,
  "code" : 200,
  "data" : {
    "totalCount" : 5,
    "alcohols" : [ {
      "alcoholId" : 1,
      "korName" : "글렌피딕",
      "engName" : "Glenfiddich",
      "rating" : 2.0,
      "ratingCount" : 35,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : false,
      "popularScore" : 0.01
    }, {
      "alcoholId" : 2,
      "korName" : "맥캘란",
      "engName" : "Macallan",
      "rating" : 2.0,
      "ratingCount" : 40,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : true,
      "popularScore" : 0.01
    }, {
      "alcoholId" : 3,
      "korName" : "글렌리벳",
      "engName" : "Glenlivet",
      "rating" : 2.0,
      "ratingCount" : 40,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : false,
      "popularScore" : 0.0
    }, {
      "alcoholId" : 4,
      "korName" : "발베니",
      "engName" : "Balvenie",
      "rating" : 2.0,
      "ratingCount" : 72,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : true,
      "popularScore" : 0.01
    }, {
      "alcoholId" : 5,
      "korName" : "라프로익",
      "engName" : "Laphroaig",
      "rating" : 1.5,
      "ratingCount" : 22,
      "korCategory" : "싱글 몰트",
      "engCategory" : "single molt",
      "imageUrl" : "https://i.imgur.com/TE2nmYV.png",
      "isPicked" : false,
      "popularScore" : 0.01
    } ]
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 9, 373126595 ],
    "serverPathVersion" : "v1"
  }
}

$ http GET 'http://localhost:8080/api/v1/tasting-tags/extract?text=%EB%B0%94%EB%8B%90%EB%9D%BC+%ED%96%A5%EC%9D%B4+%EC%A2%8B%EA%B3%A0+%EA%BF%80+%EA%B0%99%EC%9D%80+%EB%8B%A8%EB%A7%9B%EC%97%90+%EC%8A%A4%EB%AA%A8%ED%82%A4+%ED%95%A8%EC%9D%B4+%EB%8A%90%EA%BB%B4%EC%A0%B8%EC%9A%94'

{
  "success" : true,
  "code" : 200,
  "data" : [ "바닐라", "꿀", "스모키" ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 9, 618272428 ],
    "serverPathVersion" : "v1"
  }
}

POST /api/v1/reviews

{
  "alcoholId" : 1,
  "status" : "PUBLIC",
  "content" : "맛있어요",
  "sizeType" : "GLASS",
  "price" : 30000,
  "locationInfo" : {
    "locationName" : "xxPub",
    "zipCode" : "12345",
    "address" : "서울시 강남구 청담동",
    "detailAddress" : "xx빌딩",
    "category" : "PUB",
    "mapUrl" : "https://api.bottle-note.com",
    "latitude" : "111.111",
    "longitude" : "222.222"
  },
  "imageUrlList" : [ {
    "order" : 1,
    "viewUrl" : "https://api.bottle-note.com/images/1"
  }, {
    "order" : 2,
    "viewUrl" : "https://api.bottle-note.com/images/2"
  }, {
    "order" : 3,
    "viewUrl" : "https://api.bottle-note.com/images/3"
  } ],
  "tastingTagList" : [ "테이스팅태그1", "테이스팅태그2", "테이스팅태그3" ],
  "rating" : 0.5
}

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 358

{
  "success" : true,
  "code" : 200,
  "data" : {
    "id" : 1,
    "content" : "맛있어요",
    "callback" : "https://bottle-note.com/api/v1/reviews/1"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : [ 2026, 4, 8, 22, 53, 10, 853543649 ],
    "serverPathVersion" : "v1"
  }
}

GET /api/v1/reviews/{alcoholId}

$ http GET 'https://api.bottle-note.com/api/v1/reviews/1?sortType=POPULAR&sortOrder=DESC&cursor=0&pageSize=2'