API Issue

이슈

전체 목록 조회

GET /api/issues?query

query {
    is: "open" || "closed",
    author: "userId",
    labels: "label01,label02,...",
    milestone: "milestoneName",
    assignee: "userId01, userId02,...",
    commenter: "userId01,userId02,...",
}

// example
// "%2c" : comma(,)
query = "is=open&author=seokju2ng&labels=server%2cbug"

queries when clicked filter buttons

"Open Issues": "is=open"
"Your Issues": "author=me"
"Everything assigned to you": "assignee=me"
"Everything commented by you": "commenter=me"
"Closed Issues": "is=closed"

• response

[
    {
        num, 
        title, 
        author: { num, id },
        createdAt,
        isClosed,
        labels: [ { num, name, color }, ... ],
        milestone: { num, name },
        assignees: [ { num, id }, ... ]
    },
    ...
]

단일 이슈 조회

GET /api/issues/:num

• response status code

code	설명
200	정상적으로 조회
404	조회를 요청한 번호가 없는 경우
500	내부 서버 에러

• response

{
  num, 
  title, 
  author: { num, id },
  createdAt,
  isClosed,
  milestone: { 
    num, 
    name, 
    openedIssues,
    closedIssues
  },
  assignees: [ { num, id }, ... ],
  labels:[ { num, name, color }, ... ],
  comments: [
    {
      num,
      content,
      writer: { num, id },
      createdAt,
    },
    ...
  ]
}

이슈 추가

POST /api/issues

• request data

{ 
    title,
    content,
    milestoneNum,
    labels: [ num01, num02, ... ],
    assignees: [ num01, num02, ... ],
}

• response status code

code	설명
200	정상적으로 생성
500	내부 서버 에러

• response

{ 
  success,
  message: 에러시에만 에러 메시지가 응답에 포함됨
}

이슈 삭제

DELETE /api/issues/:num

• response status code

code	설명
200	정상적으로 삭제
404	삭제를 요청한 번호가 없는 경우
500	내부 서버 에러

• response

{ 
  success,
  message: 에러시에만 에러 메시지가 응답에 포함됨
}

이슈 수정

PUT /api/issues/:num

• request data:

{ 
  title, 
  milestoneNum 
}

• response status code

code	설명
200	정상적으로 수정
404	수정을 요청한 번호가 없는 경우
404	등록을 요청한 마일스톤 번호가 없는 경우
500	내부 서버 에러

• response

{ 
  success,
  message: 에러시에만 에러 메시지가 응답에 포함됨
}

To-do

이슈에 레이블 지정

이슈에 마일스톤 지정

이슈에 assignee 지정

코멘트 추가 API

코멘트 수정 API

코멘트 삭제 API