posts | Notion

<aside> 💡 게시글 생성

HTTP 메소드: POST
URI: /posts
요청 헤더: Authorization: Bearer 액세스토큰
요청 데이터:

{
    "title": "제목",
    "content": "내용"
}

응답 데이터:

{
    "code": 201,
    "message": "게시글이 생성되었습니다.",
    "data": {
        "postNumber": 1,
        "user": {
            "userId": "eunli",
            "nickname": "은리은리",
            "profileImage": "<https://michi-bucket.s3.ap-northeast-2.amazonaws.com/81eb2c55_a413_4127_80e2_6b7fc4d5844a_poorin.jpeg>",
            "birthYear": "2000",
            "phoneNumber": "01066667777",
            "role": "user",
            "state": "가입",
            "createdAt": "2024-05-19T20:34:08.086Z",
            "updatedAt": "2024-05-28T15:51:23.772Z",
            "deletedAt": null
        },
        "title": "제목",
        "content": "내용",
        "createdAt": "2024-05-28T16:46:34.224Z",
        "updatedAt": "2024-05-28T16:46:34.224Z",
        "deletedAt": null
    }
}

</aside>

<aside> 💡 모든 게시글 조회

HTTP 메소드: GET
URI: /posts
요청 헤더: Authorization: Bearer 액세스토큰
요청 데이터:
- query
  - page: number (nullable)
  - pageSize: number (nullable)
응답 데이터:

{
    "code": 200,
    "message": "모든 게시글이 조회되었습니다.",
    "data": [
        {
            "postNumber": 7,
            "user": {
                "userId": "eunlii",
                "nickname": "은리닉넴",
                "profileImage": null,
                "birthYear": "2004",
                "phoneNumber": "01066663332",
                "role": "user",
                "state": "가입",
                "createdAt": "2024-05-28T19:32:06.442Z",
                "updatedAt": "2024-05-28T19:32:06.442Z",
                "deletedAt": null
            },
            "title": "제목",
            "content": "내용수정수정수정",
            "createdAt": "2024-05-28T19:33:17.482Z",
            "updatedAt": "2024-05-28T19:34:28.691Z",
            "deletedAt": null
        },
        {
            "postNumber": 5,
            "user": {
                "userId": "eunli",
                "nickname": "은리은리",
                "profileImage": "<https://michi-bucket.s3.ap-northeast-2.amazonaws.com/81eb2c55_a413_4127_80e2_6b7fc4d5844a_poorin.jpeg>",
                "birthYear": "2000",
                "phoneNumber": "01066667777",
                "role": "user",
                "state": "가입",
                "createdAt": "2024-05-19T20:34:08.086Z",
                "updatedAt": "2024-05-28T15:51:23.772Z",
                "deletedAt": "2024-05-20T00:44:37.459Z"
            },
            "title": "제목",
            "content": "내용",
            "createdAt": "2024-05-28T16:47:35.451Z",
            "updatedAt": "2024-05-28T16:47:35.451Z",
            "deletedAt": null
        },
        {
            "postNumber": 3,
            "user": {
                "userId": "eunli",
                "nickname": "은리은리",
                "profileImage": "<https://michi-bucket.s3.ap-northeast-2.amazonaws.com/81eb2c55_a413_4127_80e2_6b7fc4d5844a_poorin.jpeg>",
                "birthYear": "2000",
                "phoneNumber": "01066667777",
                "role": "user",
                "state": "가입",
                "createdAt": "2024-05-19T20:34:08.086Z",
                "updatedAt": "2024-05-28T15:51:23.772Z",
                "deletedAt": "2024-05-20T00:44:37.459Z"
            },
            "title": "제목",
            "content": "내용",
            "createdAt": "2024-05-28T16:47:05.293Z",
            "updatedAt": "2024-05-28T16:47:05.293Z",
            "deletedAt": null
        }
    ],
    "meta": {
        "page": 1,
        "pageSize": 3,
        "total": 5,
        "pageCount": 2,
        "hasPreviousPage": false,
        "hasNextPage": true
    }
}

</aside>

<aside> 💡 단일 게시글 조회

HTTP 메소드: GET
URI: /posts/:postNumber
요청 헤더: Authorization: Bearer 액세스토큰
요청 데이터: 없음
응답 데이터:

{
    "code": 200,
    "message": "게시글이 조회되었습니다.",
    "data": {
        "postNumber": 7,
        "user": {
            "userId": "eunli",
            "nickname": "은리은리",
            "profileImage": "<https://michi-bucket.s3.ap-northeast-2.amazonaws.com/81eb2c55_a413_4127_80e2_6b7fc4d5844a_poorin.jpeg>",
            "birthYear": "2000",
            "phoneNumber": "01066667777",
            "role": "user",
            "state": "가입",
            "createdAt": "2024-05-19T20:34:08.086Z",
            "updatedAt": "2024-05-28T15:51:23.772Z",
            "deletedAt": "2024-05-20T00:44:37.459Z"
        },
        "title": "제목",
        "content": "내용",
        "createdAt": "2024-05-28T15:56:30.385Z",
        "updatedAt": "2024-05-28T15:56:30.385Z",
        "deletedAt": null
    }
}

응답 데이터: { code: 404, message: "게시글을 찾을 수 없습니다." } </aside>

<aside> 💡 게시글 수정

HTTP 메소드: PATCH
URI: /posts/:postNumber
요청 헤더: Authorization: Bearer 액세스토큰
요청 데이터:

{
    "title": "제목", // 옵셔널
    "content": "내용" // 옵셔널
}

응답 데이터:

{
    "code": 200,
    "message": "게시글이 수정되었습니다.",
    "data": {
        "postNumber": 6,
        "user": {
            "userId": "eunli",
            "nickname": "은리은리",
            "profileImage": "<https://michi-bucket.s3.ap-northeast-2.amazonaws.com/81eb2c55_a413_4127_80e2_6b7fc4d5844a_poorin.jpeg>",
            "birthYear": "2000",
            "phoneNumber": "01066667777",
            "role": "user",
            "state": "가입",
            "createdAt": "2024-05-19T20:34:08.086Z",
            "updatedAt": "2024-05-28T15:51:23.772Z",
            "deletedAt": "2024-05-20T00:44:37.459Z"
        },
        "title": "제목",
        "content": "내용수정수정",
        "createdAt": "2024-05-28T16:50:22.898Z",
        "updatedAt": "2024-05-28T17:02:02.382Z",
        "deletedAt": null
    }
}

응답 데이터: { code: 403, message: "게시글을 수정할 권한이 없습니다." }
응답 데이터: { code: 404, message: "게시글을 찾을 수 없습니다." } </aside>

<aside> 💡 게시글 삭제

HTTP 메소드: DELETE
URI: /posts/:postNumber
요청 헤더: Authorization: Bearer 액세스토큰
요청 데이터: 없음
응답 데이터: { code: 200, message: "게시글이 삭제되었습니다." }
응답 데이터: { code: 403, message: "게시글을 삭제할 권한이 없습니다." }
응답 데이터: { code: 404, message: "게시글을 찾을 수 없습니다." } </aside>