Bottle Note Admin API 문서

POST http://localhost:8080/admin/api/v1/example
Content-Type: application/json

{
  "userId": "일", // 숫자 값이 필요한데 문자열 값이 들어온 경우
  "targetId": 0,
  "type": "EXAMPLE",
  "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/admin/api/v1/example
Content-Type: application/json

{
  "userId": "", // 필수적인 값이 없는 경우
  "targetId": 0,
  "type": "EXAMPLE",
  "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"
  }
}

POST /admin/api/v1/auth/login

POST /v1/auth/login HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 68
Host: localhost:8080

{
  "email" : "admin@bottlenote.com",
  "password" : "password123"
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 358

{
  "success" : true,
  "code" : 200,
  "data" : {
    "accessToken" : "so9UjlTPUTpQe0Buhh66pIeABCiGuFbq",
    "refreshToken" : "gUHtQCCqQIdn6jxUMUQHFVKwpv3rW3xj"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:09.860221286",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/auth/refresh

POST /v1/auth/refresh HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 47
Host: localhost:8080

{
  "refreshToken" : "existing_refresh_token"
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 358

{
  "success" : true,
  "code" : 200,
  "data" : {
    "accessToken" : "FSI4hpFmX8W3atOO7Rr75lOqn8pa1aZY",
    "refreshToken" : "OtauoJweEziJX1kjpZAR7kH0x0nVY5e1"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:09.886586895",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/auth/signup

POST /v1/auth/signup HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer test_access_token
Content-Length: 142
Host: localhost:8080

{
  "email" : "new@bottlenote.com",
  "password" : "password123",
  "name" : "새 어드민",
  "roles" : [ "PARTNER", "COMMUNITY_MANAGER" ]
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 379

{
  "success" : true,
  "code" : 200,
  "data" : {
    "adminId" : 1,
    "email" : "new@bottlenote.com",
    "name" : "새 어드민",
    "roles" : [ "PARTNER", "COMMUNITY_MANAGER" ]
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:09.82390184",
    "serverPathVersion" : "v1"
  }
}

DELETE /admin/api/v1/auth/withdraw

DELETE /v1/auth/withdraw HTTP/1.1
Authorization: Bearer test_access_token
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 294

{
  "success" : true,
  "code" : 200,
  "data" : {
    "message" : "탈퇴 처리되었습니다."
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:09.778230037",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/alcohols

$ curl 'http://localhost:8080/v1/alcohols?keyword=%EA%B8%80%EB%A0%8C&category=SINGLE_MALT&regionId=1&sortType=KOR_NAME&sortOrder=ASC&page=0&size=20' -i -X GET

GET /v1/alcohols?keyword=%EA%B8%80%EB%A0%8C&category=SINGLE_MALT&regionId=1&sortType=KOR_NAME&sortOrder=ASC&page=0&size=20 HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1020

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "alcoholId" : 1,
    "korName" : "테스트 위스키 1",
    "engName" : "Test Whisky 1",
    "korCategoryName" : "싱글몰트",
    "engCategoryName" : "Single Malt",
    "imageUrl" : "https://example.com/image.jpg",
    "createdAt" : "2024-01-01T00:00:00",
    "modifiedAt" : "2024-06-01T00:00:00",
    "deletedAt" : null
  }, {
    "alcoholId" : 2,
    "korName" : "테스트 위스키 2",
    "engName" : "Test Whisky 2",
    "korCategoryName" : "싱글몰트",
    "engCategoryName" : "Single Malt",
    "imageUrl" : "https://example.com/image.jpg",
    "createdAt" : "2024-02-01T00:00:00",
    "modifiedAt" : "2024-07-01T00:00:00",
    "deletedAt" : null
  } ],
  "errors" : [ ],
  "meta" : {
    "page" : 0,
    "size" : 20,
    "totalElements" : 2,
    "totalPages" : 1,
    "hasNext" : false,
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-05T16:33:05.780995547",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/alcohols/lookup

$ curl 'http://localhost:8080/v1/alcohols/lookup?keyword=macallan&category=SINGLE_MALT&regionId=1&distilleryId=10&cursor=0&pageSize=20' -i -X GET

GET /v1/alcohols/lookup?keyword=macallan&category=SINGLE_MALT&regionId=1&distilleryId=10&cursor=0&pageSize=20 HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 998

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "alcoholId" : 1,
    "korName" : "맥캘란 12년",
    "engName" : "Macallan 12",
    "korCategoryName" : "싱글몰트",
    "engCategoryName" : "Single Malt",
    "categoryGroup" : "SINGLE_MALT",
    "regionId" : 1,
    "korRegion" : "스페이사이드",
    "engRegion" : "Speyside",
    "distilleryId" : 10,
    "korDistillery" : "맥캘란",
    "engDistillery" : "Macallan",
    "imageUrl" : "https://example.com/alcohol.png"
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:06.800911148",
    "pageable" : {
      "currentCursor" : 0,
      "cursor" : 20,
      "pageSize" : 20,
      "hasNext" : false
    },
    "searchParameters" : {
      "keyword" : "macallan",
      "category" : "SINGLE_MALT",
      "regionId" : 1,
      "distilleryId" : 10,
      "cursor" : 0,
      "pageSize" : 20
    },
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/alcohols/{alcoholId}

$ curl 'http://localhost:8080/v1/alcohols/1' -i -X GET

GET /v1/alcohols/1 HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1240

{
  "success" : true,
  "code" : 200,
  "data" : {
    "alcoholId" : 1,
    "korName" : "글렌피딕 12년",
    "engName" : "Glenfiddich 12 Year",
    "imageUrl" : "https://example.com/image.jpg",
    "type" : "WHISKY",
    "korCategory" : "싱글몰트",
    "engCategory" : "Single Malt",
    "categoryGroup" : "SINGLE_MALT",
    "abv" : "40%",
    "age" : "12",
    "cask" : "오크",
    "volume" : "700ml",
    "description" : "스코틀랜드의 대표적인 싱글몰트 위스키",
    "regionId" : 1,
    "korRegion" : "스코틀랜드",
    "engRegion" : "Scotland",
    "distilleryId" : 1,
    "korDistillery" : "글렌피딕",
    "engDistillery" : "Glenfiddich",
    "tastingTags" : [ {
      "id" : 1,
      "korName" : "바닐라",
      "engName" : "Vanilla"
    }, {
      "id" : 2,
      "korName" : "꿀",
      "engName" : "Honey"
    } ],
    "avgRating" : 4.2,
    "totalRatingsCount" : 150,
    "reviewCount" : 45,
    "pickCount" : 200,
    "createdAt" : "2024-01-01T00:00:00",
    "modifiedAt" : "2024-06-01T00:00:00"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:06.616235582",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/alcohols

$ curl 'http://localhost:8080/v1/alcohols' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "korName" : "테스트 위스키",
  "engName" : "Test Whisky",
  "abv" : "40%",
  "type" : "WHISKY",
  "korCategory" : "싱글 몰트",
  "engCategory" : "Single Malt",
  "categoryGroup" : "SINGLE_MALT",
  "regionId" : 1,
  "distilleryId" : 1,
  "age" : "12",
  "cask" : "American Oak",
  "imageUrl" : "https://example.com/test.jpg",
  "description" : "테스트 설명",
  "volume" : "700ml",
  "tastingTagIds" : [ 1, 2 ]
}'

POST /v1/alcohols HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 429
Host: localhost:8080

{
  "korName" : "테스트 위스키",
  "engName" : "Test Whisky",
  "abv" : "40%",
  "type" : "WHISKY",
  "korCategory" : "싱글 몰트",
  "engCategory" : "Single Malt",
  "categoryGroup" : "SINGLE_MALT",
  "regionId" : 1,
  "distilleryId" : 1,
  "age" : "12",
  "cask" : "American Oak",
  "imageUrl" : "https://example.com/test.jpg",
  "description" : "테스트 설명",
  "volume" : "700ml",
  "tastingTagIds" : [ 1, 2 ]
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 394

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "ALCOHOL_CREATED",
    "message" : "위스키가 등록되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:06"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:07.001160527",
    "serverPathVersion" : "v1"
  }
}

PUT /admin/api/v1/alcohols/{alcoholId}

$ curl 'http://localhost:8080/v1/alcohols/1' -i -X PUT \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "korName" : "수정된 위스키",
  "engName" : "Updated Whisky",
  "abv" : "40%",
  "type" : "WHISKY",
  "korCategory" : "싱글 몰트",
  "engCategory" : "Single Malt",
  "categoryGroup" : "SINGLE_MALT",
  "regionId" : 1,
  "distilleryId" : 1,
  "age" : "12",
  "cask" : "American Oak",
  "imageUrl" : "https://example.com/test.jpg",
  "description" : "테스트 설명",
  "volume" : "700ml",
  "tastingTagIds" : [ 1, 2 ]
}'

PUT /v1/alcohols/1 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 432
Host: localhost:8080

{
  "korName" : "수정된 위스키",
  "engName" : "Updated Whisky",
  "abv" : "40%",
  "type" : "WHISKY",
  "korCategory" : "싱글 몰트",
  "engCategory" : "Single Malt",
  "categoryGroup" : "SINGLE_MALT",
  "regionId" : 1,
  "distilleryId" : 1,
  "age" : "12",
  "cask" : "American Oak",
  "imageUrl" : "https://example.com/test.jpg",
  "description" : "테스트 설명",
  "volume" : "700ml",
  "tastingTagIds" : [ 1, 2 ]
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 394

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "ALCOHOL_UPDATED",
    "message" : "위스키가 수정되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:07"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:07.037433776",
    "serverPathVersion" : "v1"
  }
}

DELETE /admin/api/v1/alcohols/{alcoholId}

$ curl 'http://localhost:8080/v1/alcohols/1' -i -X DELETE

DELETE /v1/alcohols/1 HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 394

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "ALCOHOL_DELETED",
    "message" : "위스키가 삭제되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:06"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:06.579416643",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/alcohols/categories/reference

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 837

{
  "success" : true,
  "code" : 200,
  "data" : {
    "SINGLE_MALT" : [ {
      "korCategory" : "싱글 몰트",
      "engCategory" : "Single Malt"
    } ],
    "BLEND" : [ {
      "korCategory" : "블렌디드",
      "engCategory" : "Blend"
    } ],
    "BLENDED_MALT" : [ {
      "korCategory" : "블렌디드 몰트",
      "engCategory" : "Blended Malt"
    } ],
    "BOURBON" : [ {
      "korCategory" : "버번",
      "engCategory" : "Bourbon"
    } ],
    "RYE" : [ ],
    "OTHER" : [ {
      "korCategory" : "테네시",
      "engCategory" : "Tennessee"
    }, {
      "korCategory" : "콘",
      "engCategory" : "Corn"
    } ]
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:06.701321869",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/helps

GET /v1/helps?status=WAITING&type=WHISKEY&cursor=0&pageSize=20 HTTP/1.1
Authorization: Bearer test_access_token
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 700

{
  "success" : true,
  "code" : 200,
  "data" : {
    "content" : {
      "totalCount" : 1,
      "helpList" : [ {
        "helpId" : 1,
        "userId" : 100,
        "userNickname" : "테스트유저",
        "title" : "위스키 관련 문의",
        "type" : "WHISKEY",
        "status" : "WAITING",
        "createAt" : "2026-07-05T16:33:12.805268811"
      } ]
    },
    "cursorPageable" : {
      "currentCursor" : 0,
      "cursor" : 20,
      "pageSize" : 20,
      "hasNext" : false
    }
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:12.809138529",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/helps/{helpId}

GET /v1/helps/1 HTTP/1.1
Authorization: Bearer test_access_token
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 732

{
  "success" : true,
  "code" : 200,
  "data" : {
    "helpId" : 1,
    "userId" : 100,
    "userNickname" : "테스트유저",
    "title" : "위스키 관련 문의",
    "content" : "위스키에 대해 문의드립니다.",
    "type" : "WHISKEY",
    "imageUrlList" : [ {
      "order" : 1,
      "viewUrl" : "https://example.com/image.jpg"
    } ],
    "status" : "WAITING",
    "adminId" : null,
    "responseContent" : null,
    "createAt" : "2026-07-05T16:33:12.732184289",
    "lastModifyAt" : "2026-07-05T16:33:12.732196077"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:12.739978737",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/helps/{helpId}/answer

POST /v1/helps/1/answer HTTP/1.1
Content-Type: application/json;charset=UTF-8
Authorization: Bearer test_access_token
Content-Length: 75
Host: localhost:8080

{
  "responseContent" : "답변 내용입니다.",
  "status" : "SUCCESS"
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 341

{
  "success" : true,
  "code" : 200,
  "data" : {
    "helpId" : 1,
    "status" : "SUCCESS",
    "message" : "답변이 등록되었습니다."
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:12.789279398",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/s3/presign-url

GET /v1/s3/presign-url?rootPath=admin%2Fbanner&uploadSize=2&contentType=image%2Fjpeg HTTP/1.1
Authorization: Bearer test_access_token
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 777

{
  "success" : true,
  "code" : 200,
  "data" : {
    "bucketName" : "bottlenote-bucket",
    "uploadSize" : 2,
    "expiryTime" : 5,
    "imageUploadInfo" : [ {
      "order" : 1,
      "viewUrl" : "https://cdn.example.com/admin/banner/uuid-1.jpg",
      "uploadUrl" : "https://s3.ap-northeast-2.amazonaws.com/bucket/admin/banner/uuid-1.jpg?X-Amz-Algorithm=..."
    }, {
      "order" : 2,
      "viewUrl" : "https://cdn.example.com/admin/banner/uuid-2.jpg",
      "uploadUrl" : "https://s3.ap-northeast-2.amazonaws.com/bucket/admin/banner/uuid-2.jpg?X-Amz-Algorithm=..."
    } ]
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:12.258145839",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/tasting-tags

$ curl 'http://localhost:8080/v1/tasting-tags?keyword=&page=0&size=20&sortOrder=ASC' -i -X GET

GET /v1/tasting-tags?keyword=&page=0&size=20&sortOrder=ASC HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 924

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "id" : 1,
    "korName" : "태그1",
    "engName" : "Tag1",
    "icon" : "icon1.png",
    "description" : "테이스팅 태그 설명 1",
    "parent" : null,
    "children" : null
  }, {
    "id" : 2,
    "korName" : "태그2",
    "engName" : "Tag2",
    "icon" : "icon2.png",
    "description" : "테이스팅 태그 설명 2",
    "parent" : null,
    "children" : null
  }, {
    "id" : 3,
    "korName" : "태그3",
    "engName" : "Tag3",
    "icon" : "icon3.png",
    "description" : "테이스팅 태그 설명 3",
    "parent" : null,
    "children" : null
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:09.202319782",
    "size" : 3,
    "totalPages" : 1,
    "hasNext" : false,
    "page" : 0,
    "serverPathVersion" : "v1",
    "totalElements" : 3
  }
}

GET /admin/api/v1/tasting-tags/{tagId}

$ curl 'http://localhost:8080/v1/tasting-tags/1' -i -X GET

GET /v1/tasting-tags/1 HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1058

{
  "success" : true,
  "code" : 200,
  "data" : {
    "tag" : {
      "id" : 1,
      "korName" : "바닐라",
      "engName" : "Vanilla",
      "icon" : "base64icon",
      "description" : "바닐라 향",
      "parent" : null,
      "children" : [ {
        "id" : 2,
        "korName" : "바닐라 크림",
        "engName" : "Vanilla Cream",
        "icon" : null,
        "description" : "바닐라 크림 향",
        "parent" : null,
        "children" : [ ]
      } ]
    },
    "alcohols" : [ {
      "alcoholId" : 1,
      "korName" : "글렌피딕 12년",
      "engName" : "Glenfiddich 12",
      "korCategoryName" : "싱글몰트",
      "engCategoryName" : "Single Malt",
      "imageUrl" : "https://example.com/image.jpg",
      "createdAt" : "2024-01-01T00:00:00",
      "modifiedAt" : "2024-06-01T00:00:00",
      "deletedAt" : null
    } ]
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:09.149837144",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/tasting-tags

$ curl 'http://localhost:8080/v1/tasting-tags' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "korName" : "바닐라",
  "engName" : "Vanilla",
  "icon" : "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "description" : "바닐라 향",
  "parentId" : null
}'

POST /v1/tasting-tags HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 221
Host: localhost:8080

{
  "korName" : "바닐라",
  "engName" : "Vanilla",
  "icon" : "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "description" : "바닐라 향",
  "parentId" : null
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 408

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "TASTING_TAG_CREATED",
    "message" : "테이스팅 태그가 등록되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:09"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:09.088396437",
    "serverPathVersion" : "v1"
  }
}

PUT /admin/api/v1/tasting-tags/{tagId}

$ curl 'http://localhost:8080/v1/tasting-tags/1' -i -X PUT \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "korName" : "바닐라 수정",
  "engName" : "Vanilla Updated",
  "icon" : "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "description" : "수정된 설명"
}'

PUT /v1/tasting-tags/1 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 218
Host: localhost:8080

{
  "korName" : "바닐라 수정",
  "engName" : "Vanilla Updated",
  "icon" : "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
  "description" : "수정된 설명"
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 408

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "TASTING_TAG_UPDATED",
    "message" : "테이스팅 태그가 수정되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:09"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:09.293479321",
    "serverPathVersion" : "v1"
  }
}

DELETE /admin/api/v1/tasting-tags/{tagId}

$ curl 'http://localhost:8080/v1/tasting-tags/1' -i -X DELETE

DELETE /v1/tasting-tags/1 HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 408

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "TASTING_TAG_DELETED",
    "message" : "테이스팅 태그가 삭제되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:09"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:09.124509858",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/tasting-tags/{tagId}/alcohols

$ curl 'http://localhost:8080/v1/tasting-tags/1/alcohols' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "alcoholIds" : [ 1, 2, 3 ]
}'

POST /v1/tasting-tags/1/alcohols HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 32
Host: localhost:8080

{
  "alcoholIds" : [ 1, 2, 3 ]
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 404

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "TASTING_TAG_ALCOHOL_ADDED",
    "message" : "위스키가 연결되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:09"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:09.267410654",
    "serverPathVersion" : "v1"
  }
}

DELETE /admin/api/v1/tasting-tags/{tagId}/alcohols

$ curl 'http://localhost:8080/v1/tasting-tags/1/alcohols' -i -X DELETE \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "alcoholIds" : [ 1, 2 ]
}'

DELETE /v1/tasting-tags/1/alcohols HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 29
Host: localhost:8080

{
  "alcoholIds" : [ 1, 2 ]
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 413

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "TASTING_TAG_ALCOHOL_REMOVED",
    "message" : "위스키 연결이 해제되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:09"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:09.242324704",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/regions

$ curl 'http://localhost:8080/v1/regions?keyword=&page=0&size=20&sortOrder=ASC' -i -X GET

GET /v1/regions?keyword=&page=0&size=20&sortOrder=ASC HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1328

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "id" : 1,
    "korName" : "스코틀랜드",
    "engName" : "Scotland",
    "continent" : "유럽",
    "description" : "지역 설명 1",
    "imageUrl" : "https://example.com/region1.png",
    "createdAt" : "2024-01-01T00:00:00",
    "modifiedAt" : "2024-06-01T00:00:00",
    "parentId" : null,
    "sortOrder" : 9999
  }, {
    "id" : 2,
    "korName" : "아일랜드",
    "engName" : "Ireland",
    "continent" : "유럽",
    "description" : "지역 설명 2",
    "imageUrl" : "https://example.com/region2.png",
    "createdAt" : "2024-01-02T00:00:00",
    "modifiedAt" : "2024-06-02T00:00:00",
    "parentId" : null,
    "sortOrder" : 9999
  }, {
    "id" : 3,
    "korName" : "일본",
    "engName" : "Japan",
    "continent" : "아시아",
    "description" : "지역 설명 3",
    "imageUrl" : "https://example.com/region3.png",
    "createdAt" : "2024-01-03T00:00:00",
    "modifiedAt" : "2024-06-03T00:00:00",
    "parentId" : null,
    "sortOrder" : 9999
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:08.522876061",
    "size" : 3,
    "totalPages" : 1,
    "hasNext" : false,
    "page" : 0,
    "serverPathVersion" : "v1",
    "totalElements" : 3
  }
}

PATCH /admin/api/v1/regions/bulk/reorder

{ "ids": [3, 1, 6, 5] }

$ curl 'http://localhost:8080/v1/regions/bulk/reorder' -i -X PATCH \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "ids" : [ 3, 1, 6, 5 ]
}'

PATCH /v1/regions/bulk/reorder HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 28
Host: localhost:8080

{
  "ids" : [ 3, 1, 6, 5 ]
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 418

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "REGION_SORT_ORDER_UPDATED",
    "message" : "지역 정렬 순서가 변경되었습니다.",
    "targetId" : null,
    "responseAt" : "2026-07-05 16:33:08"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:08.574603316",
    "serverPathVersion" : "v1"
  }
}

PATCH /admin/api/v1/regions/{parentId}/children/bulk/reorder

부모 지역 ID = 1

변경 전

정렬 슬롯:       1    10    20    30
              +----+-----+-----+-----+
자식 지역 ID: | 11 |  1  |  3  |  5  |
              +----+-----+-----+-----+

요청

{ "ids": [3, 1] }

변경 후

정렬 슬롯:       1    10    20    30
              +----+-----+-----+-----+
자식 지역 ID: |  3 |  1  | 11  |  5  |
              +----+-----+-----+-----+

$ curl 'http://localhost:8080/v1/regions/1/children/bulk/reorder' -i -X PATCH \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "ids" : [ 30, 10, 60, 50 ]
}'

PATCH /v1/regions/1/children/bulk/reorder HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 32
Host: localhost:8080

{
  "ids" : [ 30, 10, 60, 50 ]
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 415

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "REGION_SORT_ORDER_UPDATED",
    "message" : "지역 정렬 순서가 변경되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:08"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:08.593275258",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/distilleries

$ curl 'http://localhost:8080/v1/distilleries?keyword=&page=0&size=20&sortOrder=ASC' -i -X GET

GET /v1/distilleries?keyword=&page=0&size=20&sortOrder=ASC HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1056

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "id" : 1,
    "korName" : "글렌피딕",
    "engName" : "Glenfiddich",
    "imageUrl" : "https://example.com/logo1.png",
    "createdAt" : "2024-01-01T00:00:00",
    "modifiedAt" : "2024-06-01T00:00:00",
    "sortOrder" : 9999
  }, {
    "id" : 2,
    "korName" : "맥캘란",
    "engName" : "Macallan",
    "imageUrl" : "https://example.com/logo2.png",
    "createdAt" : "2024-01-02T00:00:00",
    "modifiedAt" : "2024-06-02T00:00:00",
    "sortOrder" : 9999
  }, {
    "id" : 3,
    "korName" : "야마자키",
    "engName" : "Yamazaki",
    "imageUrl" : "https://example.com/logo3.png",
    "createdAt" : "2024-01-03T00:00:00",
    "modifiedAt" : "2024-06-03T00:00:00",
    "sortOrder" : 9999
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:07.818555928",
    "size" : 3,
    "totalPages" : 1,
    "hasNext" : false,
    "page" : 0,
    "serverPathVersion" : "v1",
    "totalElements" : 3
  }
}

PATCH /admin/api/v1/distilleries/bulk/reorder

{ "ids": [3, 1, 6, 5] }

변경 전

정렬 슬롯:    1    10    20    30    40
           +----+-----+-----+-----+-----+
증류소 ID: | 11 |  1  |  3  |  5  |  6  |
           +----+-----+-----+-----+-----+

변경 후

정렬 슬롯:    1    10    20    30    40
           +----+-----+-----+-----+-----+
증류소 ID: |  3 |  1  |  6  |  5  | 11  |
           +----+-----+-----+-----+-----+

$ curl 'http://localhost:8080/v1/distilleries/bulk/reorder' -i -X PATCH \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "ids" : [ 3, 1, 6, 5 ]
}'

PATCH /v1/distilleries/bulk/reorder HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 28
Host: localhost:8080

{
  "ids" : [ 3, 1, 6, 5 ]
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 425

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "DISTILLERY_SORT_ORDER_UPDATED",
    "message" : "증류소 정렬 순서가 변경되었습니다.",
    "targetId" : null,
    "responseAt" : "2026-07-05 16:33:07"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:07.886636975",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/curations

$ curl 'http://localhost:8080/v1/curations?keyword=&isActive=true&page=0&size=20' -i -X GET

GET /v1/curations?keyword=&isActive=true&page=0&size=20 HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 831

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "id" : 1,
    "name" : "큐레이션 1",
    "alcoholCount" : 2,
    "displayOrder" : 1,
    "isActive" : true,
    "createdAt" : "2024-01-01T00:00:00"
  }, {
    "id" : 2,
    "name" : "큐레이션 2",
    "alcoholCount" : 4,
    "displayOrder" : 2,
    "isActive" : true,
    "createdAt" : "2024-02-01T00:00:00"
  }, {
    "id" : 3,
    "name" : "큐레이션 3",
    "alcoholCount" : 6,
    "displayOrder" : 3,
    "isActive" : true,
    "createdAt" : "2024-03-01T00:00:00"
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.197298",
    "size" : 3,
    "totalPages" : 1,
    "hasNext" : false,
    "page" : 0,
    "serverPathVersion" : "v1",
    "totalElements" : 3
  }
}

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

$ curl 'http://localhost:8080/v1/curations/1' -i -X GET

GET /v1/curations/1 HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1628

{
  "success" : true,
  "code" : 200,
  "data" : {
    "id" : 1,
    "name" : "테스트 큐레이션",
    "description" : "큐레이션 설명입니다.",
    "coverImageUrl" : "https://example.com/cover.jpg",
    "displayOrder" : 1,
    "isActive" : true,
    "alcohols" : [ {
      "alcoholId" : 1,
      "korName" : "테스트 위스키 1",
      "engName" : "Test Whisky 1",
      "korCategoryName" : "싱글몰트",
      "engCategoryName" : "Single Malt",
      "imageUrl" : "https://example.com/image.jpg",
      "createdAt" : "2024-01-01T00:00:00",
      "modifiedAt" : "2024-06-01T00:00:00",
      "deletedAt" : null
    }, {
      "alcoholId" : 2,
      "korName" : "테스트 위스키 2",
      "engName" : "Test Whisky 2",
      "korCategoryName" : "싱글몰트",
      "engCategoryName" : "Single Malt",
      "imageUrl" : "https://example.com/image.jpg",
      "createdAt" : "2024-02-01T00:00:00",
      "modifiedAt" : "2024-07-01T00:00:00",
      "deletedAt" : null
    }, {
      "alcoholId" : 3,
      "korName" : "테스트 위스키 3",
      "engName" : "Test Whisky 3",
      "korCategoryName" : "싱글몰트",
      "engCategoryName" : "Single Malt",
      "imageUrl" : "https://example.com/image.jpg",
      "createdAt" : "2024-03-01T00:00:00",
      "modifiedAt" : "2024-08-01T00:00:00",
      "deletedAt" : null
    } ],
    "createdAt" : "2024-01-01T00:00:00",
    "modifiedAt" : "2024-06-01T00:00:00"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.163510897",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/curations

$ curl 'http://localhost:8080/v1/curations' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "name" : "새 큐레이션",
  "description" : "큐레이션 설명",
  "coverImageUrl" : "https://example.com/cover.jpg",
  "displayOrder" : 0,
  "alcoholIds" : [ ]
}'

POST /v1/curations HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 171
Host: localhost:8080

{
  "name" : "새 큐레이션",
  "description" : "큐레이션 설명",
  "coverImageUrl" : "https://example.com/cover.jpg",
  "displayOrder" : 0,
  "alcoholIds" : [ ]
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 398

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_CREATED",
    "message" : "큐레이션이 등록되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:11"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.109008027",
    "serverPathVersion" : "v1"
  }
}

PUT /admin/api/v1/curations/{curationId}

$ curl 'http://localhost:8080/v1/curations/1' -i -X PUT \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "name" : "수정된 큐레이션",
  "description" : "수정된 설명",
  "coverImageUrl" : "https://example.com/updated.jpg",
  "displayOrder" : 1,
  "isActive" : true,
  "alcoholIds" : [ 1, 2 ]
}'

PUT /v1/curations/1 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 202
Host: localhost:8080

{
  "name" : "수정된 큐레이션",
  "description" : "수정된 설명",
  "coverImageUrl" : "https://example.com/updated.jpg",
  "displayOrder" : 1,
  "isActive" : true,
  "alcoholIds" : [ 1, 2 ]
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 398

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_UPDATED",
    "message" : "큐레이션이 수정되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:11"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.297254993",
    "serverPathVersion" : "v1"
  }
}

DELETE /admin/api/v1/curations/{curationId}

$ curl 'http://localhost:8080/v1/curations/1' -i -X DELETE

DELETE /v1/curations/1 HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 398

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_DELETED",
    "message" : "큐레이션이 삭제되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:11"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.138638518",
    "serverPathVersion" : "v1"
  }
}

PATCH /admin/api/v1/curations/{curationId}/status

$ curl 'http://localhost:8080/v1/curations/1/status' -i -X PATCH \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "isActive" : false
}'

PATCH /v1/curations/1/status HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 24
Host: localhost:8080

{
  "isActive" : false
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 422

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_STATUS_UPDATED",
    "message" : "큐레이션 활성화 상태가 변경되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:11"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.351483218",
    "serverPathVersion" : "v1"
  }
}

PATCH /admin/api/v1/curations/{curationId}/display-order

$ curl 'http://localhost:8080/v1/curations/1/display-order' -i -X PATCH \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "displayOrder" : 5
}'

PATCH /v1/curations/1/display-order HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 24
Host: localhost:8080

{
  "displayOrder" : 5
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 425

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_DISPLAY_ORDER_UPDATED",
    "message" : "큐레이션 노출 순서가 변경되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:11"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.32332855",
    "serverPathVersion" : "v1"
  }
}

PATCH /admin/api/v1/curations/bulk/reorder

{ "ids": [3, 1, 6, 5] }

변경 전

정렬 슬롯:      1    10    20    30    40
             +----+-----+-----+-----+-----+
큐레이션 ID: | 11 |  1  |  3  |  5  |  6  |
             +----+-----+-----+-----+-----+

변경 후

정렬 슬롯:      1    10    20    30    40
             +----+-----+-----+-----+-----+
큐레이션 ID: |  3 |  1  |  6  |  5  | 11  |
             +----+-----+-----+-----+-----+

$ curl 'http://localhost:8080/v1/curations/bulk/reorder' -i -X PATCH \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "ids" : [ 3, 1, 6, 5 ]
}'

PATCH /v1/curations/bulk/reorder HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 28
Host: localhost:8080

{
  "ids" : [ 3, 1, 6, 5 ]
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 429

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_DISPLAY_ORDER_UPDATED",
    "message" : "큐레이션 노출 순서가 변경되었습니다.",
    "targetId" : null,
    "responseAt" : "2026-07-05 16:33:11"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.272890603",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/curations/{curationId}/alcohols

$ curl 'http://localhost:8080/v1/curations/1/alcohols' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "alcoholIds" : [ 1, 2, 3 ]
}'

POST /v1/curations/1/alcohols HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 32
Host: localhost:8080

{
  "alcoholIds" : [ 1, 2, 3 ]
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 417

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_ALCOHOL_ADDED",
    "message" : "큐레이션에 위스키가 추가되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:11"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.249372254",
    "serverPathVersion" : "v1"
  }
}

DELETE /admin/api/v1/curations/{curationId}/alcohols/{alcoholId}

$ curl 'http://localhost:8080/v1/curations/1/alcohols/5' -i -X DELETE

DELETE /v1/curations/1/alcohols/5 HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 421

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_ALCOHOL_REMOVED",
    "message" : "큐레이션에서 위스키가 제거되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:11"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.22730451",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v2/curation-specs

$ curl 'http://localhost:8080/v2/curation-specs' -i -X GET

GET /v2/curation-specs HTTP/1.1
Host: localhost:8080

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "id" : 1,
    "code" : "RECOMMENDED_WHISKY",
    "name" : "추천 위스키",
    "description" : "추천 위스키 카드 목록",
    "version" : 1,
    "isActive" : true
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.756323659",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v2/curation-specs/{specId}

$ curl 'http://localhost:8080/v2/curation-specs/1' -i -X GET

GET /v2/curation-specs/1 HTTP/1.1
Host: localhost:8080

{
  "success" : true,
  "code" : 200,
  "data" : {
    "id" : 1,
    "code" : "RECOMMENDED_WHISKY",
    "name" : "추천 위스키",
    "description" : "추천 위스키 카드 목록",
    "hydratorKey" : "alcohol",
    "version" : 1,
    "isActive" : true,
    "requestSpec" : {
      "type" : "object",
      "required" : [ "source", "alcohol" ]
    },
    "responseSpec" : {
      "type" : "object"
    }
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.836636938",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v2/curations

$ curl 'http://localhost:8080/v2/curations?keyword=&code=RECOMMENDED_WHISKY&isActive=true&page=0&size=20' -i -X GET

GET /v2/curations?keyword=&code=RECOMMENDED_WHISKY&isActive=true&page=0&size=20 HTTP/1.1
Host: localhost:8080

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "id" : 1,
    "specId" : 1,
    "specCode" : "RECOMMENDED_WHISKY",
    "name" : "비 오는 날 위스키",
    "displayOrder" : 1,
    "isActive" : true,
    "createdAt" : "2026-05-15T00:00:00"
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.787052633",
    "size" : 1,
    "totalPages" : 1,
    "hasNext" : false,
    "page" : 0,
    "serverPathVersion" : "v1",
    "totalElements" : 1
  }
}

GET /admin/api/v2/curations/{curationId}

$ curl 'http://localhost:8080/v2/curations/1' -i -X GET

GET /v2/curations/1 HTTP/1.1
Host: localhost:8080

{
  "success" : true,
  "code" : 200,
  "data" : {
    "id" : 1,
    "name" : "비 오는 날 위스키",
    "description" : "스모키 위스키 추천",
    "coverImageUrl" : "https://cdn.example.com/cover.jpg",
    "imageUrls" : [ "https://cdn.example.com/cover.jpg" ],
    "exposureStartDate" : "2026-06-01",
    "exposureEndDate" : "2026-06-30",
    "displayOrder" : 1,
    "isActive" : true,
    "createdAt" : "2026-05-15T00:00:00",
    "modifiedAt" : "2026-05-15T00:00:00",
    "spec" : {
      "id" : 1,
      "code" : "RECOMMENDED_WHISKY",
      "name" : "추천 위스키",
      "description" : "추천 위스키 카드 목록",
      "hydratorKey" : "alcohol",
      "version" : 1,
      "isActive" : true,
      "requestSpec" : {
        "type" : "object",
        "required" : [ "source", "alcohol" ]
      },
      "responseSpec" : {
        "type" : "object"
      }
    },
    "payload" : {
      "source" : "BOTTLE_NOTE",
      "alcohol" : {
        "korName" : "테스트 위스키"
      }
    }
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.80862729",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v2/curations

$ curl 'http://localhost:8080/v2/curations' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "specId" : 1,
  "name" : "비 오는 날 위스키",
  "description" : "스모키 위스키 추천",
  "imageUrls" : [ "https://cdn.example.com/cover.jpg" ],
  "exposureStartDate" : "2026-06-01",
  "exposureEndDate" : "2026-06-30",
  "displayOrder" : 1,
  "isActive" : true,
  "payload" : {
    "source" : "BOTTLE_NOTE",
    "alcohol" : {
      "korName" : "테스트 위스키"
    }
  }
}'

POST /v2/curations HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 394
Host: localhost:8080

{
  "specId" : 1,
  "name" : "비 오는 날 위스키",
  "description" : "스모키 위스키 추천",
  "imageUrls" : [ "https://cdn.example.com/cover.jpg" ],
  "exposureStartDate" : "2026-06-01",
  "exposureEndDate" : "2026-06-30",
  "displayOrder" : 1,
  "isActive" : true,
  "payload" : {
    "source" : "BOTTLE_NOTE",
    "alcohol" : {
      "korName" : "테스트 위스키"
    }
  }
}

{
  "specId" : 1,
  "name" : "비 오는 날 위스키",
  "description" : "스모키 위스키 추천",
  "imageUrls" : [ "https://cdn.example.com/cover.jpg" ],
  "exposureStartDate" : "2026-06-01",
  "exposureEndDate" : "2026-06-30",
  "displayOrder" : 1,
  "isActive" : true,
  "payload" : {
    "source" : "BOTTLE_NOTE",
    "alcohol" : {
      "korName" : "테스트 위스키"
    }
  }
}

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_CREATED",
    "message" : "큐레이션이 등록되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:11"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.739643811",
    "serverPathVersion" : "v1"
  }
}

PUT /admin/api/v2/curations/{curationId}

$ curl 'http://localhost:8080/v2/curations/1' -i -X PUT \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "specId" : 1,
  "name" : "수정된 큐레이션",
  "description" : "스모키 위스키 추천",
  "imageUrls" : [ "https://cdn.example.com/cover.jpg" ],
  "exposureStartDate" : "2026-06-01",
  "exposureEndDate" : "2026-06-30",
  "displayOrder" : 1,
  "isActive" : true,
  "payload" : {
    "source" : "BOTTLE_NOTE",
    "alcohol" : {
      "korName" : "테스트 위스키"
    }
  }
}'

PUT /v2/curations/1 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 392
Host: localhost:8080

{
  "specId" : 1,
  "name" : "수정된 큐레이션",
  "description" : "스모키 위스키 추천",
  "imageUrls" : [ "https://cdn.example.com/cover.jpg" ],
  "exposureStartDate" : "2026-06-01",
  "exposureEndDate" : "2026-06-30",
  "displayOrder" : 1,
  "isActive" : true,
  "payload" : {
    "source" : "BOTTLE_NOTE",
    "alcohol" : {
      "korName" : "테스트 위스키"
    }
  }
}

{
  "specId" : 1,
  "name" : "수정된 큐레이션",
  "description" : "스모키 위스키 추천",
  "imageUrls" : [ "https://cdn.example.com/cover.jpg" ],
  "exposureStartDate" : "2026-06-01",
  "exposureEndDate" : "2026-06-30",
  "displayOrder" : 1,
  "isActive" : true,
  "payload" : {
    "source" : "BOTTLE_NOTE",
    "alcohol" : {
      "korName" : "테스트 위스키"
    }
  }
}

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_UPDATED",
    "message" : "큐레이션이 수정되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-07-05 16:33:11"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-07-06T01:33:11.778027752",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/users

$ curl 'http://localhost:8080/v1/users?keyword=&status=ACTIVE&sortType=CREATED_AT&sortOrder=DESC&page=0&size=20' -i -X GET

GET /v1/users?keyword=&status=ACTIVE&sortType=CREATED_AT&sortOrder=DESC&page=0&size=20 HTTP/1.1
Host: localhost:8080