diff --git a/src/main/java/org/swyp/linkit/domain/market/controller/SkillMarketController.java b/src/main/java/org/swyp/linkit/domain/market/controller/SkillMarketController.java index 6980b4a5..83abba1c 100644 --- a/src/main/java/org/swyp/linkit/domain/market/controller/SkillMarketController.java +++ b/src/main/java/org/swyp/linkit/domain/market/controller/SkillMarketController.java @@ -42,7 +42,8 @@ public class SkillMarketController { summary = "스킬 카드 목록 조회", description = "스킬 장터 메인 페이지에 표시될 노출 중인 스킬 카드 목록을 조회합니다. " + "카테고리 및 검색 키워드 파라미터를 통해 필터링할 수 있습니다. " - + "첫 요청은 cursorId 없이 size=11, 이후 요청은 응답의 nextCursorId 를 cursorId 로 전달해주세요." + + "첫 요청은 cursorId 없이 요청하고, 이후 요청은 응답의 nextCursorId 를 cursorId 로 전달해주세요. " + + "size 는 1~48 사이로 지정할 수 있습니다. (기본값 11)" ) @GetMapping(value = "/skills", produces = MediaType.APPLICATION_JSON_VALUE) public ResponseEntity> getSkillCards( @@ -55,8 +56,8 @@ public ResponseEntity> getSkillCards( @Parameter(description = "커서 ID, 첫 요청 시 생략", example = "10") @RequestParam(required = false) Long cursorId, - @Parameter(description = "페이지 사이즈, 첫 요청 11 / 이후 요청 12", example = "11") - @Min(1) @Max(20) @RequestParam(required = false, defaultValue = "11") int size) { + @Parameter(description = "페이지 사이즈 (1~48), 기본값 11", example = "11") + @Min(1) @Max(48) @RequestParam(required = false, defaultValue = "11") int size) { log.info("[SkillMarket] GET /market/skills : category={}, searchKeyword={}, cursorId={}, size={}", category, searchKeyword, cursorId, size); diff --git a/src/main/java/org/swyp/linkit/domain/market/service/SkillMarketService.java b/src/main/java/org/swyp/linkit/domain/market/service/SkillMarketService.java index 355c4c38..39775512 100644 --- a/src/main/java/org/swyp/linkit/domain/market/service/SkillMarketService.java +++ b/src/main/java/org/swyp/linkit/domain/market/service/SkillMarketService.java @@ -39,7 +39,7 @@ public class SkillMarketService { * 스킬 장터 목록 커서 기반 페이징 조회 * - category, keyword 는 선택적 필터 * - cursorId : null 이면 첫 페이지, 값이 있으면 해당 id 미만 조회 - * - 첫 페이지 size = 11 (배너 영역 고려), 이후 size = 12 + * - size : 1~48 (기본값 11, 컨트롤러에서 검증) * - 검색어 집계는 SearchKeywordRecorder 에 위임 (Redis INCR) */ @Transactional(readOnly = true)