API Documents

API 설계

User API를 제외한 모든 API에 header로 인증 token값을 넣는다.

headers:{
 'Authorization': 'Bearer ${tokenString}'
}

User

Method	url	description
GET	api/user/oauth/naver	naver 아이디로 로그인
GET	api/user/me	사용 중인 user의 정보 확인

Project

Project CRUD

Method	url	description
GET	api/project	project 전체 조회
GET	api/project/:projectId	project 개별 조회
POST	api/project	project 생성
PATCH	api/project/:projectId	project 제목 수정
PUT	api/project/:projectId	project 수정
DELETE	api/project/:projectId	project 삭제

Section CUD

Method	url	description
POST	api/project/:projectId/section	section 생성
PATCH	api/project/:projectId/section/:sectionId	section 제목 수정
DELETE	api/project/:projectId/section/:sectionId	section 삭제

Project

Project CRUD

Method	url	description
GET	/api/task/:taskId	task 개별 조회
POST	api/task	task 생성
PATCH	api/task/:taskId	task 수정
DELETE	api/task/:taskId	task 삭제

Alarm CRUD

Method	url	description
POST	/api/task/:taskId/alarm	개별 task 알람 추가
PUT	/api/task/:taskId/alarm	개별 task 알람 변경
DELETE	/api/task/:taskId/alarm	개별 task 알람 삭제

Comment CUD

Method	URL	Description
GET	/api/task/:taskId/comment	task에 달린 모든 comment 조회
POST	/api/task/:taskId/comment	task에 comment 생성
PUT	/api/task/:taskId/comment/:commentId	task에 달린 comment 수정
DELETE	/api/task/:taskId/comment/:commentId	task에 달린 comment 삭제

Bookmark CRUD

Method	URL	Description
GET	/api/task/:taskId/bookmark	bookmark 전체 조회
POST	/api/task/:taskId/bookmark	bookmark 생성
PUT	/api/task/:taskId/bookmark/:bookmarkId	bookmark 수정
DELETE	/api/task/:taskId/bookmark/:bookmarkId	bookmark 삭제

Task GET API

URL

GET /api/task/:taskId

Response

{
    id : 1,
    title: '작업1',
    labels: [{id: 1, title: 'FE'},],
    priority: {id: 1, title: '우선순위1'},
    alarm: { ... },
    dueDate: '2020-11-18',
    createdAt: '2020-11-18T07:12:41.000Z',
    updatedAt: '2020-11-18T07:12:41.000Z'
    childTasks: [{id: 2, title: ...},{}, ...],
}

Task Post API

URL

POST /api/task

Request

{
    title : '할일',
    projectId: 1,
    labelIdList: [1,2,3],
    priorityId: 1,
    alarm: {...},
    dueDate: '2020-11-18',
    parentId: 3
}

Response

{
    id: 1,
    message: 'ok'
}

Task Patch API

URL

PATCH /api/task/:taskId

Request

{
    title : '할일 변경' || undefined,
    dueDate: '2020-11-19' || undefined,
    projectId: 1 || undefined,
    labelIds: [1, 2, 3] || undefined,
    priority: 3 || undefined,
    parentId : 1 || undefined,
}

Response

{
    message: 'ok'
}

Task Delete API

URL

DELETE /api/task/:taskId

Response

{
    message: 'ok'
}

Task - Alarm Post API

URL

POST /api/task/:taskId/alarm

Request

Response

Task - Alarm Put API

URL

PUT /api/task/:taskId/alarm

Request

Response

Task - Alarm Delete API

URL

DELETE /api/task/:taskId/alarm

Response

Task - Comment Get API

URL

GET /api/task/:taskId/comment

Response

{
    comments:
    [
        {
            id: 1,
            content: 'https://...'
        }
    ]
}

Task - Comment Post API

URL

POST /api/task/:taskId/comment

Request

{
    content : '[내일 봐야할 것](https://www.naver.com) 공부하자!'
}

Response

{
    id: 1,
    message: 'ok'
}

Task - Comment PUT API

URL

PUT /api/task/:taskId/comment/:commentId

Request

{
    'content': '코멘트 수정'
}

Response

{
    'message': 'ok'
}

Task - Comment DELETE API

URL

DELETE /api/task/:taskId/comment/:commentId

Response

{
    'message': 'ok'
}

Task - Bookmark Get API

URL

GET /api/task/:taskId/bookmark

Response

{
    bookmarks:
    {
        id: 1,
        url: 'https://....'
    }
}

Task - Bookmark Post API

URL

POST /api/task/:taskId/bookmark

Request

{
    url : 'https://...'
}

Response

{
    id: 1,
    message: 'ok'
}

Task - Bookmark PUT API

URL

PUT /api/task/:taskId/bookmark/:bookmarkId

Request

{
    url : 'https://another...'
}

Response

{
    'message': 'ok'
}

Task - Bookmark DELETE API

URL

DELETE /api/task/:taskId/bookmark/:bookmarkId

Response

{
    'message': 'ok'
}

Label

Method	URL	Description
GET	api/label	label 전체 조회
POST	api/label	label 생성
PUT	api/label/:labelId	label 수정
DELETE	api/label/:labelId	label 삭제