카테고리 별 게시물 조회하기

지정된 카테고리의 게시물을 조회하는 API입니다.

METHOD

GET

URL

/category/:level1, /category/:level1/:level2

• level1: 상위 카테고리 이름(string)

• level2: 하위 카테고리 이름(string)

Url Example

/category/개발 파트별 게시판?page=0&size=2&sort=post.id,desc

Query String

name	type	require	description
page	number	선택, 기본값 = 0	불러올 페이지, 0부터 시작
size	number	선택, 기본값 = 20	불러올 게시물 개수
sort	string	선택	정렬 기준, 게시물 최신 순: sort:post.id,desc 정렬 기준 한개 이상 가능 sort=post.likeCount,desc&sort=post.viewCount,desc

RESPONSE

• totalNum: post 객체의 개수 (number)

• postList: post 리스트 (post List)

  • post: 게시물 정보

    • id: 게시물 고유 id (number)

    • category: 게시물 카테고리 정보 (object)

      • id: 카테고리 id (number)

      • name: 카테고리 이름 (string)

      • level: 카레고리 level, 항상 2

      • postNum: 카테고리가 가지고 있는 게시물 수 (number)

      • parentCategoryId: 상위 카테고리 id, 항상 1

    • user: 작성자 정보 (object)

      • email: 이메일 (string)

      • name: 이름 (string)

      • nickname: 별명 (string)

      • profileImage: 작성자 프로필 사진 (이미지 링크 string or base64 encoded string / BLOB)

    • title: 게시물 제목 (string)

    • content: 게시물 내용 (string)

    • likeCount: 좋아요 수 (number)

    • viewCount: 조회수 (number)

RESPONSE EXAMPLE

success

HTTP Status code : 200 OK

{
    "totalNum": 2,
    "postList": [
        {
            "id": 11,
            "category": {
                "id": 7,
                "name": "프론트엔드",
                "level": 2,
                "postNum": 2,
                "parentCategoryId": 2
            },
            "user": {
                "email": "[e-mail]",
                "name": "박주은",
                "nickname": "hoit1302",
                "profileImage": "https://edsc-s3.s3.ap-northeast-2.amazonaws.com/profile-image/1"
            },
            "title": "카테고리 jueun 새로 생성되었는지 post test",
            "content": "day6 💛⛄",
            "likeCount": 0,
            "viewCount": 1
        },
        {
            "id": 18,
            "category": {
                "id": 7,
                "name": "프론트엔드",
                "level": 2,
                "postNum": 2,
                "parentCategoryId": 2
            },
            "user": {
                "email": "[e-mail]",
                "name": "박주은",
                "nickname": "hoit1302",
                "profileImage": "https://edsc-s3.s3.ap-northeast-2.amazonaws.com/profile-image/1"
            },
            "title": "react study1",
            "content": "react study~~~",
            "likeCount": 0,
            "viewCount": 0
        }
    ]
}

fail

HTTP Status code : 400 Bad Request

{
    "status": "BAD_REQUEST",
    "message": "존재하지 않는 카테고리입니다."
}

name	type	description
status	string	HTTP status
message	string	에러 메시지