2.2.API_challenges - YOOGOMJA/github_garden_mern GitHub Wiki

기본 항목들이 아닌 연산,분석된 정보가 필요한 경우 사용됩니다.
관련 파일

GET

• /api/challenges/
  : 모든 도전 기간을 조회합니다.

• /api/challenges/latest
  : 가장 최근 도전 기간을 조회합니다.

• /api/challenges/:challenge_id
  : 특정 도전 기간을 조회합니다. 도전 기간 id가 필요합니다.

• /api/challenges/users/:user_name
  : 특정 사용자가 참여한 도전 기간을 모두 조회합니다.

• /api/challenges/:challenge_id/users
  : 특정 도전 기간에 참여중인 모든 사용자를 조회합니다.

POST

• /api/challenges/:challenge_id/users/:user_name
  : 특정 도전 기간에 특정 사용자를 추가합니다. 도전 기간과 사용자가 존재해야 합니다.

• /api/challenges/
  : 새로운 도전기간을 생성합니다. body에 포함되어야 하는 항목은 다음과 같습니다.

interface InsertChallenge{
  start_dt : string,   // 도전 시작 일자 , YYYY-MM-DD 형태 문자열
  finish_dt : string,  // 도전 종료 일자 , YYYY-MM-DD 형태 문자열
  title : string,      // 도전 제목
}

PUT

• /api/challenges/:challenge_id
  : 특정 도전 기간의 정보를 수정합니다. 적어도 하나의 정보가 주어져야 합니다.

interface PutChallenge{
  start_dt? : string,   // 도전 시작 일자 , YYYY-MM-DD 형태 문자열
  finish_dt? : string,  // 도전 종료 일자 , YYYY-MM-DD 형태 문자열
  title? : string,      // 도전 제목
}

DELETE

• /api/challenges/:challenge_id : 특정 도전 기간을 삭제 처리합니다.