friend apis

[davin111]

Figma: https://www.figma.com/file/kraIynWQJnG6lpyB9Ezkx1/SNUTT?type=design&node-id=6281-29663&mode=design&t=JUGhiViYbdRzFTxI-0

138 에 의존함

1. GET /v1/friends?state=ACTIVE

• state는 ACTIVE 면 친구 목록, REQUESTED 면 받은 친구 요청에 해당. (REQUESTING이면 내가 한 친구 요청)
• 탈퇴한 유저는 포함되지 않음
• 응답 body 는 아래와 같음. 추후의 pagination 을 고려했으나 현재는 아님.

  {
    "content": [
        {
            "id": "64c9bc5ac77e5938c721702c",
            "userId": "64c9a1a13454356ca2fde439",
            "nickname": {
                "nickname": "대담한 바닐라라떼",
                "tag": "4625"
            },
            "createdAt": "2023-08-02T02:15:54.164"
        }
    ],
    "totalCount": 1,
    "nextPageToken": null
  }

2. POST /v1/friends

• request body 에 nickname
• 존재하지 않거나 탈퇴한 유저 nickname 이면 404, 자기 자신에게 요청하면 409, 이미 요청했거나 친구 관계면 409
• 응답 body 없음

3. POST /v1/friends/{friendId}/accept

• path 의 friendId는 친구관계 id 임 (user id X)
• 잘못된 friendId 거나 자신에게 온 요청이 아니거나, 이미 accept 한 것이면 404
• 응답 body 없음

4. POST /v1/friends/{friendId}/decline

• path 의 friendId는 친구관계 id 임 (user id X)
• 잘못된 friendId 거나 자신에게 온 요청이 아니거나, 이미 accept 한 것이면 404
• 응답 body 없음

5. DELETE /v1/friends/{friendId}

• 친구 이미 맺은 후에 관계 끊기
• path 의 friendId는 친구관계 id 임 (user id X)
• 잘못된 friendId 거나 자신의 친구 관계가 아니거나, 아직 accept 안 한 것이면 404
• 응답 body 없음

[davin111]

아 참고로, 실제로는 친구 요청 시 푸시/알림함 전송이 되어야겠지만 아직은 반영 안 되어있어요. 빠르게 API 스펙을 맞추기 위한 거라. 따로 추가하겠습니다. cc. @woohm402

---

여기서 작업 완료 https://github.com/wafflestudio/snutt-timetable/pull/139/commits/1802e18c62d2648907170acea78c7753ad9bbbe9

[davin111]

@Jhvictor4 @Hank-Choi 빠른 프론트 개발을 위해 일단 merge 하겠습니다. 사후적으로라도 의견 남겨주세요.