User API Specification

기능	메서드	URI	비고
팔로우 요청	POST	/users/{user_id}/follow	⚠️
사용자 검색	GET	/users	⚠️
사용자 프로필 조회	GET	/users/{user_id}	⚠️

• ✅: 확인 완료
• ⚠️: 대기 상태
• ❌: 논의 필요

0️⃣ 타입 정의

interface User {
  id: number;
  profile_image: string;
  name: string; 
  content: string;
  relationship_status: "self" | "following" | "none"; // 🚨 질문 리스트 3
}

interface Feed { 
  id: string | number; // 🚨 질문 리스트 2
  title: string;
  content: string;
  image: string;

  like_count: number;
  comment_count: number;
};

1️⃣ 팔로우 요청

interface Request {
  uri: '/users/{user_id}/follow';
  method: 'POST';
  body : {
    user_id: number;
  }
}

interface Response {
  code: '2000';
  data: {
    // 🚨 질문 리스트 1
  };
}

2️⃣ 사용자 검색

우선 모든 입력으로 진행, 추후 쓰로틀링 / 디바운스 도입 가능

// 일반 사용자 검색
interface Request {
  uri: "/search/users";
  method: "GET"
  query:{
    user_id: number;
  }
}

interface Response {
    code: "2000";
    data:{
        domains: User[] // 0️⃣ User
    }
}

// 좋아요 사용자 검색
interface Request {
  uri: "/search/like";
  method: "GET"
  query:{
    user_id: number;
  }
}

interface Response {
    code: "2000";
    data:{
        domains: User[] // 0️⃣ User
    }
}

// 사용자 + (게시물 검색 - 추후 등록된다면)
`/search/top?q=${}`

// (게시물 검색 - 추후 등록된다면)
`/search/posts?q=${}`

3️⃣ 사용자 프로필 조회

interface Request {
  uri: '/users/{user_id}';
  method: 'GET';
}

interface Response {
  code: "2000";
  data : {
    user: User; // 0️⃣ User
    feeds: Feed[]; // 0️⃣ Feed
  }
}

🚨 질문 리스트

1. 작성 완료, 좋아요 성공, 신고 성공에 대한 응답 데이터는 무엇으로 설정해야 하나요?
2. 게시물, 유저와 같은 고유 Id 타입 확정 필요 (string vs bigint)
3. 팔로우 여부와 자기 게시물 여부에 대한 여부 체킹에 대한 방법
   • 변수 하나로 체크하는 방법 relationship_status: 'self' | 'following' | 'none'
   • 변수 두개로 체크하는 방법 is_follow: boolean is_self_feed: boolean