From 56df5b1411d83ebc8b77baef6410529db8e1d008 Mon Sep 17 00:00:00 2001 From: Baek HyeonBin <81628455+WhiteBin-bin@users.noreply.github.com> Date: Thu, 4 Jun 2026 13:50:23 +0900 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9A=20Docs:=20Scalar=20API=20Reference?= =?UTF-8?q?=20=EC=84=A4=EB=AA=85=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 반려동물 목록 및 가족 신청 관련 목록 API의 sort 문서를 실제 구현 기준으로 정리 - 잘못된 정렬 예시값(`regDate`, `createdDate`, `requestedAt` 등) 제거 - `registrationCreatedAt`, `registrationUpdatedAt`, `registrationStatus` 기준으로 설명 통일 - 신청순, 처리순, 상태순에 대한 사용자 관점 설명 반영 Closes #149 --- .../java/com/dodo/backend/pet/controller/PetController.java | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/main/java/com/dodo/backend/pet/controller/PetController.java b/src/main/java/com/dodo/backend/pet/controller/PetController.java index 5d764c4..d9fe882 100644 --- a/src/main/java/com/dodo/backend/pet/controller/PetController.java +++ b/src/main/java/com/dodo/backend/pet/controller/PetController.java @@ -289,7 +289,7 @@ public ResponseEntity handleFamilyApproval( @Parameters({ @Parameter(name = "page", description = "조회할 페이지 번호 (0부터 시작)", in = ParameterIn.QUERY, example = "0"), @Parameter(name = "size", description = "한 페이지에 보여줄 데이터 수", in = ParameterIn.QUERY, example = "10"), - @Parameter(name = "sort", description = "정렬 기준 (예: regDate,desc)", in = ParameterIn.QUERY, example = "regDate,desc") + @Parameter(name = "sort", description = "정렬 기준 (가능 값: registrationCreatedAt, registrationUpdatedAt / 예: registrationCreatedAt,desc)", in = ParameterIn.QUERY, example = "registrationCreatedAt,desc") }) @ApiResponses(value = { @ApiResponse(responseCode = "200", description = "조회를 성공했습니다.", @@ -335,7 +335,7 @@ public ResponseEntity getPetList( @Parameters({ @Parameter(name = "page", description = "조회할 페이지 번호 (0부터 시작)", in = ParameterIn.QUERY, example = "0"), @Parameter(name = "size", description = "한 페이지에 보여줄 데이터 수", in = ParameterIn.QUERY, example = "10"), - @Parameter(name = "sort", description = "정렬 기준 (예: createdDate,desc)", in = ParameterIn.QUERY, example = "createdDate,desc") + @Parameter(name = "sort", description = "정렬 기준 (가능 값: registrationCreatedAt, registrationUpdatedAt / 예: registrationCreatedAt,desc)", in = ParameterIn.QUERY, example = "registrationCreatedAt,desc") }) @ApiResponses(value = { @ApiResponse(responseCode = "200", description = "조회를 성공했습니다.", @@ -384,7 +384,7 @@ public ResponseEntity getAllPendingUsers( @Parameters({ @Parameter(name = "page", description = "조회할 페이지 번호 (0부터 시작)", in = ParameterIn.QUERY, example = "0"), @Parameter(name = "size", description = "한 페이지에 보여줄 데이터 수", in = ParameterIn.QUERY, example = "10"), - @Parameter(name = "sort", description = "정렬 기준 (예: createdDate,desc)", in = ParameterIn.QUERY, example = "createdDate,desc") + @Parameter(name = "sort", description = "정렬 기준 (가능 값: registrationCreatedAt, registrationUpdatedAt / 예: registrationCreatedAt,desc)", in = ParameterIn.QUERY, example = "registrationCreatedAt,desc") }) @ApiResponses(value = { @ApiResponse(responseCode = "200", description = "조회를 성공했습니다.",