HomeAboutMeBlogGuest
© 2025 Sejin Cha. All rights reserved.
Built with Next.js, deployed on Vercel
🧚
[1기]최종 프로젝트 데브코스
/
[팀3] 아이육
[팀3] 아이육
/
🎁
API 설계
/
실종/보호 게시글 리스트 조회 API

실종/보호 게시글 리스트 조회 API

완료여부
완료여부
상태
200
uri
/api/v1/missing-posts
담당자
범키
비고
프론트 확인
태그
GET
GET요청으로 실종/보호 게시글의 목록을 조회한다.
 

Request Header

Authorization: "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
 
Query Parameter
이름
타입(쿼리스트링)
설명
requried
예시
status
String
게시글 상태
requried
PROTECTION
city
Number
시도
requried
1
town
Number
시군구
requried
13
animal
Number
동물
1
animalKind
String
품종
3
sex
String
성별
FEMALE
start
String
게시글 작성시간 기준 조회 시작 날짜
2021-11-11
end
String
게시글 작성시간 기준 조회 끝 날짜
2021-11-12
page
Number
페이지
1
size
Number
요청 개수
10
sort
String
날짜순 정렬
createdAt,desc(asc)
 

Response

{ "data": { "posts": [ { "id": 1, "city": "서울특별시", "town": "도봉구", "animalKindName": "토이푸들", "status": "DETECTION", "createdAt": "2021-11-05T16:55:37.436056" "sex": "FEMALE", "isBookmark": true, "bookmarkCount": 2, "tags": [ { "id": 1, "name": "고슴도치" } ], "thumbnail": "http://../../97fd3403-7343-497a-82fa-c41d26ccf0f8.png" }, { "id": 2, "city": "서울특별시", "town": "도봉구", "animalKindName": "UNKNOWN", "status": "MISSING", "createdAt": "2021-11-05T16:55:37.436056" "sex": "UNKNOWN", "isBookmark": false, "bookmarkCount": 2, "tags": [ { "id": 1, "name": "고슴도치" } ], "thumbnail": null } ], "totalElements": 10, "last": false, "size": 10, "serverDateTime": "2021-11-05T16:55:37.436056" }
 
Response Fields
이름
타입
설명
비고
data
Obejct
응답 본문
data.posts
ARRAY
게시글 리스트
data.posts[].id
Number
게시글 아이디
data.posts[].city
String
시도
data.posts[].town
String
시군구
data.posts[].animalKindName
String
품종 종류
data.posts[].status
String
게시글 상태
data.posts[].createdAt
String
게시글 작성날짜
data.posts[].sex
String
성별
data.posts[].isBookmark
Boolean
사용자가 북마크한 게시물인지
data.posts[].bookmarkCount
Number
북마크 카운트
data.posts[].tags
ARRAY
게시글 해시태그들
data.posts[].tags[].name
String
해시태그 값
data.posts[].thumbnail
String
NULL
썸네일
data.posts[].totalElements
Number
총 게시물 개수
data.posts[].last
Boolean
현재가 마지막 페이지인지 여부
data.posts[].size
Number
페이지 당 요청 개수
serverDateTime
String
서버 응답 시간