pick과 tag API JSON 형식 논의

[dmdgpdi]

@enigsuss @dmdgpdi @Gyaak @kimminkyeu @sangwonsheep
pick, tag에 대한 CRUD req, resp json 형식에 대한 논의 입니다.

// 태그 목록 조회
data: [
{id:100, name:'react'},
{id:100, name:'react'}
{id:100, name:'react'}
{id:100, name:'react'}

]

// 태그 생성
data: {name:'react'},

// 태그 응답
// id, value, userId
data: {id: 105}

// 태그 삭제
data: {id:105}

// 태그 수정

data: {id:105, name:'dasdsad'}

// pick 
// 북마크 하는 기능

data: {
	userTagList:[1,2,4,5], // number[]
	linkTitle,// string
	userTitle, // string 
	linkDescription,// 일단 지금은 string이고 og:description을 찾지 못하면 '' 값을 넣는다.
	url, // string
	userMemo // string 
}

[Gyaak]

@dmdgpdi

1. 태그 이름으로 조회해야하는 경우가 있을까요?
2. 태그의 중복 이름을 허용하지 않나요?

[dmdgpdi]

1. 태그 이름으로만 조회를 해야하는 경우는 없을 것 같습니다.
2. 지금 당장 태그의 중복 이름은 허용하지 않아야 할 것 같습니다.

[Gyaak]

사용자 태그 조회 응답 예시

• 태그의 순서가 보장되어야 하기 때문에 순서를 나타낼 수 있는 필드가 있어야할 것 같습니다. 또한 userId를 추가했습니다.

{
  "userId": 2,
  "tags": [
    { 
      "id": 10, 
      "name": "react", 
      "order": 1 
    },
    { 
      "id": 23, 
      "name": "spring", 
      "order": 2 
    },
    { 
      "id": 140, 
      "name": "node", 
      "order": 3 
    },
    { 
      "id": 1, 
      "name": "next", 
      "order": 4 
    }
  ]
}

---

사용자 태그 생성 요청 예시

• 태그 생성을 위해서는 userId도 필요합니다.

{
  "userId": 2,
  "tag": {
    "name": "newReact"
  }
}

---

사용자 태그 생성 응답 예시

• 생성된 태그는 가장 마지막 순서로 배치됩니다.

{
  "userId": 2,
  "tag": {
    "id" : 337
    "name": "newReact"
    "order": 4
  }
}

---

사용자 태그 수정 요청 예시

• 순서 또는 이름이 변경된 경우 해당 태그들을 json 배열로 보내면 됩니다.
• 정렬 여부는 상관 없습니다.

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

---

@dmdgpdi @enigsuss 확인부탁드립니다!

[dmdgpdi]

@Gyaak 단일 태그에 대한 수정, 삭제는 아래와 같은가요?

// 태그 삭제
{
 "userId": 2,
  "tag": {
    "id": 2
  }
}

// 태그 수정
{
 "userId": 2,
  "tag": {
    "id": 2
    "name": "new name"
  }
}

[Gyaak]

#87 확인부탁드려요!

[dmdgpdi]

감사합니다!