Tag 요청 응답 형식 정의

[Gyaak]

@dmdgpdi @enigsuss
아래 내용에서 잘못되었거나 추가할 내용이 있으면 코멘트 남겨주세요.
확인후 이상 없다면, 이모지 남겨주세요 확정되면 위키로 이관할 예정입니다.

태그 규칙

1. 사용자는 본인이 등록한 태그만 조회/수정/삭제 가능

2. 등록한 태그는 순서를 보장

• 순서는 0 또는 양의 정수로 표현되며, 값이 작을수록 순서가 빠름을 의미
• 태그 등록 시 가장 마지막 순서로 등록됨

3. 같은 사용자가 등록한 태그의 이름은 중복될 수 없음

• 사용자가 다르다면 태그의 이름은 같을 수 있음

4. 태그의 순서가 변경되었을 시, 순서가 변경된 구간의 모든 태그를 업데이트 요청으로 보내야함

• ex) 12번태그를 7번위치로 끌어올리면 7-11번 태그의 순서값이 모두 변경되어야하므로, 전부 업데이트 요청으로 보내야함

5. 태그 삭제시 해당 태그가 등록된 픽에서 해당 태그가 자동으로 삭제됨

6. 태그 등록, 수정, 삭제 요청은 개별 api 호출로 이루어 져야함

• ex) 태그를 등록하고, 등록한 태그의 순서를 바꾼 후, 해당 태그의 이름을 수정한 다음, 삭제했다면
  등록api, 수정api, 수정api, 삭제api 총 4번의 api호출이 필요

---

Tag Create Request

{
  "name" : "태그이름예시"
}

---

Tag Update Request

[
  { 
    "id": 10, 
    "name": "react1", 
    "tagOrder": 3 
  },
  { 
    "id": 23, 
    "name": "spring2", 
    "tagOrder": 1 
  },
  { 
    "id": 140, 
    "name": "node3", 
    "tagOrder": 2 
  },
  { 
    "id": 1, 
    "name": "next4", 
    "tagOrder": 4 
  }
]

---

Tag Response

• tagOrder 순서로 오름차순 정렬

[
  { 
    "id": 23, 
    "name": "spring2", 
    "tagOrder": 1 
  },
  { 
    "id": 140, 
    "name": "node3", 
    "tagOrder": 2 
  },
  { 
    "id": 10, 
    "name": "react1", 
    "tagOrder": 3 
  },
  { 
    "id": 1, 
    "name": "next4", 
    "tagOrder": 4 
  }
]

---

태그 삭제의 경우 pathvariable에 태그 id를 넣어 HTTP DELETE method로 요청

ex) DELETE : ./api/tag/{삭제할tagId}