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 /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" : "45NB0IdMDEUNFhoo6aSEJoCd4ogXTKZU",
    "refreshToken" : "H3rWo6kqoHlE1okBrRMMe5Gj8b98ACQB"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:22.765819652",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/auth/refresh

POST /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" : "ynrM8nEWwJPLLygaBSPXlHyDvvxbGQNF",
    "refreshToken" : "GmfB6SOWt0iVa1ZfYQzb4OY9O6QI8Abm"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:22.791133856",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/auth/signup

POST /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: 380

{
  "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-04-08T22:53:22.729611519",
    "serverPathVersion" : "v1"
  }
}

DELETE /admin/api/v1/auth/withdraw

DELETE /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-04-08T22:53:22.677793668",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/alcohols

$ curl 'http://localhost:8080/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 /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-04-08T13:53:18.781091333",
    "serverPathVersion" : "v1"
  }
}

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

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

GET /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-04-08T22:53:19.635627766",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/alcohols

$ curl 'http://localhost:8080/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 /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: 393

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "ALCOHOL_CREATED",
    "message" : "위스키가 등록되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-04-08 13:53:19"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:19.96254606",
    "serverPathVersion" : "v1"
  }
}

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

$ curl 'http://localhost:8080/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 /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-04-08 13:53:19"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:20.000960629",
    "serverPathVersion" : "v1"
  }
}

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

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

DELETE /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-04-08 13:53:19"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:19.595359491",
    "serverPathVersion" : "v1"
  }
}

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

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

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "korCategory" : "싱글 몰트",
    "engCategory" : "Single Malt"
  }, {
    "korCategory" : "블렌디드",
    "engCategory" : "Blended"
  }, {
    "korCategory" : "버번",
    "engCategory" : "Bourbon"
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:19.72385149",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/helps

GET /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-04-08T13:53:25.277155046"
      } ]
    },
    "cursorPageable" : {
      "currentCursor" : 0,
      "cursor" : 20,
      "pageSize" : 20,
      "hasNext" : false
    }
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:25.280926197",
    "serverPathVersion" : "v1"
  }
}

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

GET /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-04-08T13:53:25.197951792",
    "lastModifyAt" : "2026-04-08T13:53:25.197962542"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:25.203897138",
    "serverPathVersion" : "v1"
  }
}

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

POST /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: 340

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

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

GET /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-04-08T22:53:24.771985802",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/tasting-tags

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

GET /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-04-08T22:53:22.013136375",
    "size" : 3,
    "totalPages" : 1,
    "hasNext" : false,
    "page" : 0,
    "serverPathVersion" : "v1",
    "totalElements" : 3
  }
}

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

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

GET /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-04-08T22:53:21.940156174",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/tasting-tags

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

POST /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-04-08 13:53:21"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:21.858811335",
    "serverPathVersion" : "v1"
  }
}

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

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

PUT /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-04-08 13:53:22"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:22.123286378",
    "serverPathVersion" : "v1"
  }
}

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

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

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

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

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "TASTING_TAG_DELETED",
    "message" : "테이스팅 태그가 삭제되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-04-08 13:53:21"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:21.90514037",
    "serverPathVersion" : "v1"
  }
}

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

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

POST /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: 403

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "TASTING_TAG_ALCOHOL_ADDED",
    "message" : "위스키가 연결되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-04-08 13:53:22"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:22.08892647",
    "serverPathVersion" : "v1"
  }
}

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

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

DELETE /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: 412

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "TASTING_TAG_ALCOHOL_REMOVED",
    "message" : "위스키 연결이 해제되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-04-08 13:53:22"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:22.06531487",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/regions

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

GET /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: 1100

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "id" : 1,
    "korName" : "스코틀랜드",
    "engName" : "Scotland",
    "continent" : "유럽",
    "description" : "지역 설명 1",
    "createdAt" : "2024-01-01T00:00:00",
    "modifiedAt" : "2024-06-01T00:00:00",
    "parentId" : null
  }, {
    "id" : 2,
    "korName" : "아일랜드",
    "engName" : "Ireland",
    "continent" : "유럽",
    "description" : "지역 설명 2",
    "createdAt" : "2024-01-02T00:00:00",
    "modifiedAt" : "2024-06-02T00:00:00",
    "parentId" : null
  }, {
    "id" : 3,
    "korName" : "일본",
    "engName" : "Japan",
    "continent" : "아시아",
    "description" : "지역 설명 3",
    "createdAt" : "2024-01-03T00:00:00",
    "modifiedAt" : "2024-06-03T00:00:00",
    "parentId" : null
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:21.261783701",
    "size" : 3,
    "totalPages" : 1,
    "hasNext" : false,
    "page" : 0,
    "serverPathVersion" : "v1",
    "totalElements" : 3
  }
}

GET /admin/api/v1/distilleries

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

GET /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: 990

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

GET /admin/api/v1/curations

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

GET /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: 834

{
  "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-04-08T22:53:24.199658286",
    "size" : 3,
    "totalPages" : 1,
    "hasNext" : false,
    "page" : 0,
    "serverPathVersion" : "v1",
    "totalElements" : 3
  }
}

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

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

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

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

{
  "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-04-08T22:53:24.14768919",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/curations

$ curl 'http://localhost:8080/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 /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-04-08 13:53:24"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:24.083119285",
    "serverPathVersion" : "v1"
  }
}

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

$ curl 'http://localhost:8080/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 /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-04-08 13:53:24"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:24.296623245",
    "serverPathVersion" : "v1"
  }
}

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

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

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

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

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_DELETED",
    "message" : "큐레이션이 삭제되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-04-08 13:53:24"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:24.12348378",
    "serverPathVersion" : "v1"
  }
}

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

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

PATCH /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: 421

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_STATUS_UPDATED",
    "message" : "큐레이션 활성화 상태가 변경되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-04-08 13:53:24"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:24.36084034",
    "serverPathVersion" : "v1"
  }
}

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

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

PATCH /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: 426

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_DISPLAY_ORDER_UPDATED",
    "message" : "큐레이션 노출 순서가 변경되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-04-08 13:53:24"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:24.330518694",
    "serverPathVersion" : "v1"
  }
}

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

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

POST /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: 416

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "CURATION_ALCOHOL_ADDED",
    "message" : "큐레이션에 위스키가 추가되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-04-08 13:53:24"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:24.26161245",
    "serverPathVersion" : "v1"
  }
}

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

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

DELETE /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-04-08 13:53:24"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:24.24026806",
    "serverPathVersion" : "v1"
  }
}

GET /admin/api/v1/users

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

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

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

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "userId" : 1,
    "email" : "user1@example.com",
    "nickName" : "사용자1",
    "imageUrl" : "https://img.example.com/1.jpg",
    "role" : "ROLE_USER",
    "status" : "ACTIVE",
    "socialType" : [ "KAKAO" ],
    "reviewCount" : 5,
    "ratingCount" : 3,
    "picksCount" : 2,
    "createAt" : "2025-01-15T10:00:00",
    "lastLoginAt" : "2026-04-01T14:30:00"
  }, {
    "userId" : 2,
    "email" : "user2@example.com",
    "nickName" : "사용자2",
    "imageUrl" : null,
    "role" : "ROLE_USER",
    "status" : "ACTIVE",
    "socialType" : [ "GOOGLE", "APPLE" ],
    "reviewCount" : 0,
    "ratingCount" : 1,
    "picksCount" : 0,
    "createAt" : "2025-06-20T09:00:00",
    "lastLoginAt" : null
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:25.596953928",
    "size" : 2,
    "totalPages" : 1,
    "hasNext" : false,
    "page" : 0,
    "serverPathVersion" : "v1",
    "totalElements" : 2
  }
}

GET /admin/api/v1/banners

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

GET /banners?keyword=&isActive=true&bannerType=CURATION&page=0&size=20 HTTP/1.1
Host: localhost:8080

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

{
  "success" : true,
  "code" : 200,
  "data" : [ {
    "id" : 1,
    "name" : "배너 1",
    "mediaType" : "IMAGE",
    "bannerType" : "CURATION",
    "sortOrder" : 0,
    "isActive" : true,
    "startDate" : null,
    "endDate" : null,
    "createdAt" : "2024-01-01T00:00:00"
  }, {
    "id" : 2,
    "name" : "배너 2",
    "mediaType" : "IMAGE",
    "bannerType" : "CURATION",
    "sortOrder" : 1,
    "isActive" : true,
    "startDate" : null,
    "endDate" : null,
    "createdAt" : "2024-02-01T00:00:00"
  }, {
    "id" : 3,
    "name" : "배너 3",
    "mediaType" : "IMAGE",
    "bannerType" : "CURATION",
    "sortOrder" : 2,
    "isActive" : true,
    "startDate" : null,
    "endDate" : null,
    "createdAt" : "2024-03-01T00:00:00"
  } ],
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:23.468667837",
    "size" : 3,
    "totalPages" : 1,
    "hasNext" : false,
    "page" : 0,
    "serverPathVersion" : "v1",
    "totalElements" : 3
  }
}

GET /admin/api/v1/banners/{bannerId}

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

GET /banners/1 HTTP/1.1
Host: localhost:8080

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

{
  "success" : true,
  "code" : 200,
  "data" : {
    "id" : 1,
    "name" : "테스트 배너",
    "nameFontColor" : "#ffffff",
    "descriptionA" : "배너 설명A",
    "descriptionB" : "배너 설명B",
    "descriptionFontColor" : "#ffffff",
    "imageUrl" : "https://example.com/banner.jpg",
    "textPosition" : "RT",
    "isExternalUrl" : false,
    "targetUrl" : null,
    "mediaType" : "IMAGE",
    "bannerType" : "CURATION",
    "sortOrder" : 0,
    "startDate" : null,
    "endDate" : null,
    "isActive" : true,
    "createdAt" : "2024-01-01T00:00:00",
    "modifiedAt" : "2024-06-01T00:00:00"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:23.426479692",
    "serverPathVersion" : "v1"
  }
}

POST /admin/api/v1/banners

$ curl 'http://localhost:8080/banners' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "name" : "새 배너",
  "nameFontColor" : "#ffffff",
  "descriptionA" : "배너 설명A",
  "descriptionB" : "배너 설명B",
  "descriptionFontColor" : "#ffffff",
  "imageUrl" : "https://example.com/banner.jpg",
  "textPosition" : "RT",
  "isExternalUrl" : false,
  "targetUrl" : null,
  "mediaType" : "IMAGE",
  "bannerType" : "CURATION",
  "sortOrder" : 0,
  "startDate" : null,
  "endDate" : null
}'

POST /banners HTTP/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 408
Host: localhost:8080

{
  "name" : "새 배너",
  "nameFontColor" : "#ffffff",
  "descriptionA" : "배너 설명A",
  "descriptionB" : "배너 설명B",
  "descriptionFontColor" : "#ffffff",
  "imageUrl" : "https://example.com/banner.jpg",
  "textPosition" : "RT",
  "isExternalUrl" : false,
  "targetUrl" : null,
  "mediaType" : "IMAGE",
  "bannerType" : "CURATION",
  "sortOrder" : 0,
  "startDate" : null,
  "endDate" : null
}

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

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "BANNER_CREATED",
    "message" : "배너가 등록되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-04-08 13:53:23"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:23.359882666",
    "serverPathVersion" : "v1"
  }
}

PUT /admin/api/v1/banners/{bannerId}

$ curl 'http://localhost:8080/banners/1' -i -X PUT \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -d '{
  "name" : "수정된 배너",
  "nameFontColor" : "#000000",
  "descriptionA" : "수정된 설명A",
  "descriptionB" : "수정된 설명B",
  "descriptionFontColor" : "#000000",
  "imageUrl" : "https://example.com/updated.jpg",
  "textPosition" : "CENTER",
  "isExternalUrl" : false,
  "targetUrl" : null,
  "mediaType" : "IMAGE",
  "bannerType" : "CURATION",
  "sortOrder" : 1,
  "startDate" : null,
  "endDate" : null,
  "isActive" : true
}'

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

{
  "name" : "수정된 배너",
  "nameFontColor" : "#000000",
  "descriptionA" : "수정된 설명A",
  "descriptionB" : "수정된 설명B",
  "descriptionFontColor" : "#000000",
  "imageUrl" : "https://example.com/updated.jpg",
  "textPosition" : "CENTER",
  "isExternalUrl" : false,
  "targetUrl" : null,
  "mediaType" : "IMAGE",
  "bannerType" : "CURATION",
  "sortOrder" : 1,
  "startDate" : null,
  "endDate" : null,
  "isActive" : true
}

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

{
  "success" : true,
  "code" : 200,
  "data" : {
    "code" : "BANNER_UPDATED",
    "message" : "배너가 수정되었습니다.",
    "targetId" : 1,
    "responseAt" : "2026-04-08 13:53:23"
  },
  "errors" : [ ],
  "meta" : {
    "serverVersion" : "1.0.0",
    "serverEncoding" : "UTF-8",
    "serverResponseTime" : "2026-04-08T22:53:23.532852151",
    "serverPathVersion" : "v1"
  }
}

DELETE /admin/api/v1/banners/{bannerId}

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

DELETE /banners/1 HTTP/1.1
Host: localhost:8080