Free board - Gachon-P-project/Back GitHub Wiki

개요

사용자가 자유게시판에 게시물을 삽입, 조회, 수정, 삭제하는 로직

게시물 작성

  • URL

    /board/free

  • Method

    POST

  • Data Params

이름 설명 타입 필수
post_title 게시글 제목 VARCHAR(60) O
post_contents 게시글 내용 VARCHAR(1000) O
wrt_date 게시글 작성 시간 varchar(30) O
board_flag 게시판 종류(0 : 과목게시판, 1 : 자유게시판, 2 : 학과게시판) INT(11) O
user_no 사용자 학번 INT(11) O
  • Query String
이름 설명 타입 필수
reply_yn 댓글 사용 유무(0 : 사용안함, 1: 사용) VARCHAR(1) X
  • Sample Call
http://localhost:17394/boards/free

or

http://localhost:17394/boards/free?reply_yn=1
  • Data Input Exaple:
{ 
    post_title : "게시글 작성 테스트 제목",
    post_contents : "게시글 작성 테스트 내용",
    reply_yn : "1",
    major_name : "컴퓨터공학과",
    subject_name : "컴퓨터공학개론",
    professor_name : "김진영",
    user_no : 201739423
}
  • Success Response
Code: 200
Content: { id : 12 }
  • Error Response
Code: 400 BAD REQUEST
Content: { error : "null 값이 존재합니다." }

Code: 401 UNAUTHORIZED
Content: { error : "인증 실패" }

전체 게시물 조회

  • URL

    /boards/free/:boardFlag/:userNo/:page_num

  • Method

    GET

  • URL Params

이름 설명 타입 필수
board_flag 게시판 종류(0 : 과목게시판, 1 : 자유게시판, 2 : 학과게시판) INT(11) O
user_no 사용자학번 INT(11) O
page_num 가져올 페이지 번호(0부터 시작) INT(11) O
  • Sample Call
http://localhost:17394/boards/free/1/201739412/0
  • Success Response
Code: 200
Content:
[
    {
        "post_no": 516,
        "post_title": "게시글 작성 테스트 제목",
        "post_contents": "게시글 작성 테스트 내용",
        "wrt_date": "2021. 1. 7. 오후 12:57:03",
        "reply_yn": "1",
        "major_name": "컴퓨터공학과",
        "subject_name": "컴퓨터공학개론",
        "professor_name": "김진영",
        "user_no": 201739423,
        "board_flag": "0",
        "nickname": "dddddun",
        "reply_cnt": 0,
        "like_cnt": 0,
        "like_user": 0
    }
]
  • Error Response
Code: 400 BAD REQUEST
Content: { error : "null 값이 존재합니다." }

Code: 401 UNAUTHORIZED
Content: { error : "인증 실패" }

특정 게시물 조회

  • URL

    /boards/free/:boardFlag/:userNo/:word/:page_num

  • Method

    GET

  • URL Params

이름 설명 타입 필수
board_flag 게시판 종류(0 : 과목게시판, 1 : 자유게시판, 2 : 학과게시판) INT(11) O
user_no 사용자학번 INT(11) O
word 검색할 단어 String O
page_num 가져올 페이지 번호(0부터 시작) INT(11) O
  • Sample Call
http://localhost:17394/boards/free/1/201739412/test/0
  • Success Response
Code: 200
Content:

  • Error Response
Code: 400 BAD REQUEST
Content: { error : "null 값이 존재합니다." }

Code: 401 UNAUTHORIZED
Content: { error : "인증 실패" }

게시물 수정

  • URL

    /boards/major

  • Method

    PUT

  • Data Params

이름 설명 타입 필수
post_no 선택한 게시글의 글 번호(전체 글 조회에서 post_no으로 받은 번호) Int O
post_title 게시글 제목 VARCHAR(60) O
post_contents 게시글 내용 VARCHAR(1000) O
  • Data Input Exaple:
{ 
    "post_no" : "520"
    "post_title" : "게시글 수정 테스트 제목",
    "post_contents" : "게시글 수정 테스트 내용"
}
  • Sample Call
http://localhost:17394/boards/subject
  • Success Response
Code: 200
Content:
{
    "fieldCount": 0,
    "affectedRows": 1,
    "insertId": 0,
    "serverStatus": 2,
    "warningCount": 0,
    "message": "Rows matched: 1  Changed: 0  Warnings: 0",
    "protocol41": true,
    "changedRows": 0
}
  • Error Response
Code: 400 BAD REQUEST
Content: { error : "null 값이 존재합니다." }

Code: 401 UNAUTHORIZED
Content: { error : "인증 실패" }

게시물 삭제

  • URL

    /boards/free

  • Method

    DELETE

  • Data Params

이름 설명 타입 필수
post_no 선택한 게시글의 글 번호(전체 글 조회에서 post_no으로 받은 번호) INT(11) O
  • Data Input Exaple:
{ 
    "post_no" : "520"
}
  • Sample Call
http://localhost:17394/boards/free
  • Success Response
Code: 200
Content:
{
    "fieldCount": 0,
    "affectedRows": 1,
    "insertId": 0,
    "serverStatus": 2,
    "warningCount": 0,
    "message": "",
    "protocol41": true,
    "changedRows": 0
}
  • Error Response
Code: 400 BAD REQUEST
Content: { error : "null 값이 존재합니다." }

Code: 401 UNAUTHORIZED
Content: { error : "인증 실패" }
⚠️ **GitHub.com Fallback** ⚠️