📋Boards

게시판 API

게시글 목록 조회

GET /boards

전체 게시글 조회 게시글 및 댓글 내림차순 정렬

Response

200

{
  "totalCounts": 1,
  "boards": [
    "boardId": 1,
    "title": "신규 업데이트",
    "username": "admin",
    "content": "댓글 기능 업데이트",
    "createdAt": "2024-02-20T10:30:00Z",
    "updatedAt": "2024-02-20T12:00:00Z",
    "isAuthor": true
    "comments": [
      {
        "commentId": 1,
        "boardId": 1,
        "username": "user1",
        "content": "빠른 업데이트 굿",
        "createdAt": "2024-02-20T11:00:00Z",
        "updatedAt": "2024-02-20T11:00:00Z",
        "isAuthor": true
      }
    ]
  ]
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}

게시글 생성

POST /boards

새로운 게시글 작성

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
title	string	게시글의 제목
content	string	게시글의 내용

Response

201

{
  "boardId": 1,
  "title": "신규 업데이트",
  "username": "admin",
  "content": "댓글 기능 업데이트",
  "createdAt": "2024-02-20T10:30:00Z",
  "updatedAt": "2024-02-20T12:00:00Z",
  "isAuthor": true
  "comments": []
}

400

{
  "title": "title 을 입력해주세요.",
  "content": "content 를 입력해주세요."
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}

게시글 단일 조회

GET /boards/{boardId}

선택한 게시글 하나를 조회 댓글 내림차순 정렬

Headers

Name	Value
Authorization	Bearer <token>

Path Parameters

Name	Description
boardId	조회할 게시글의 ID

Response

200

{
  "boardId": 1,
  "username": "user1",
  "title": "커피 좋아",
  "content": "커피 맛있어요",
  "createdAt": "2024-02-20T15:00:00Z",
  "updatedAt": "2024-02-20T15:00:00Z",
  "isAuthor": true,
  "comments": [
    {
      "commentId": 1,
      "boardId": 1,
      "username": "user2",
      "content": "혹시 추천하는 커피가 있나요?",
      "createdAt": "2024-02-21T11:00:00Z",
      "updatedAt": "2024-02-21T11:00:00Z",
      "isAuthor": false
    }
  ]
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}

404

{
  "message": "$boardId 번 게시글을 찾을 수 없습니다."
}

게시글 수정

PUT /boards/{boardId}

작성된 게시글 수정 ADMIN 또는 작성자만 사용 가능

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Path Parameters

Name	Description
boardId	수정할 게시글의 ID

Body

Name	Type	Description
title	string	게시글의 제목
content	string	게시글의 내용

Response

200

{
  "boardId": 1,
  "username": "user1",
  "title": "커피 좋아",
  "content": "커피 맛있어요",
  "createdAt": "2024-02-20T15:00:00Z",
  "updatedAt": "2024-02-20T15:00:00Z",
  "isAuthor": true,
  "comments": [
    {
      "commentId": 1,
      "boardId": 1,
      "username": "user2",
      "content": "혹시 추천하는 커피가 있나요?",
      "createdAt": "2024-02-21T11:00:00Z",
      "updatedAt": "2024-02-21T11:00:00Z",
      "isAuthor": false
    }
  ]
}

400

{
  "title": "title 을 입력해주세요.",
  "content": "content 를 입력해주세요."
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}

403

{
  "message": "게시글 수정 권한이 없습니다."
}

404

{
  "message": "$boardId 번 게시글을 찾을 수 없습니다."
}

게시글 삭제

DELETE /boards/{boardId}

작성된 게시글 삭제 ADMIN 또는 작성자만 사용 가능

Headers

Name	Value
Authorization	Bearer <token>

Path Parameters

Name	Description
boardId	삭제할 게시글의 ID

Response

200

{
  "message": "$boardId 번 게시글이 정상적으로 삭제되었습니다."
}

401

{
  "message": "유효하지 않은 사용자 정보입니다."
}

403

{
  "message": "게시글 삭제 권한이 없습니다."
}

404

{
  "message": "$boardId 번 게시글을 찾을 수 없습니다."
}