API 명세서 - prgrms-web-devcourse-final-project/WEB4_5_GAEPPADAK_BE GitHub Wiki

상태 URL Method 설명 담당자 🗒️ 요구사항 명세 버전 수정 및 내역 수정요청 수정요청상세 요구사항 상세기능 ID 상세 설명
개발 완료 /auth/check-email-reset POST 비밀번호 재설정을 위한 이메일 인증 코드 검증 김경래             44  
개발 완료 /comments/{commentId}/like DELETE 댓글 추천 취소 김하연     [250506] 새로 추가된 api[250508] id → commentId 필드명 변경[250520] response에 profileUrl 추가       40  
개발 완료 /auth/check-password POST 비밀번호 검증 윤상민             41  
개발 완료 /news/top GET 인기 뉴스 리스트 조회 이하은 , , ,   [250429] postId 제거 / fetchedAt을 publishedAt로 수정[250505] meta에 페이지네이션 정보 추가 / score 추가[250508] sourceId 식별자 추가       39  
개발 완료 /admin/reports/posts DELETE 포스트 신고 거부 이하은             43  
개발 완료 /videos/top GET 인기 영상(유튜브) 리스트 조회 이하은 , , ,   [250429] postId 제거 / fetchedAt을 publishedAt로 수정[250505] meta에 페이지네이션 정보 추가 / score 추가[250508] sourceId 식별자 추가       38  
개발 완료 /admin/reports/comments DELETE 댓글 신고 거부 이하은             42  
개발 완료 /posts/{postId}/news GET 포스트의 출처 뉴스 조회 (최대 10개) 이화영     [250508] sourceId 식별자 추가       37  
개발 완료 /posts/search/sources GET 키워드 검색 출처 5개 최신순 조회 (페이지네이션) 이화영     [250501] request params에 keyword 추가[250507] id 및 페이지네이션 추가[250507]/keywords/search/sources/top → /posts/search/sources url 변경[250508] id → sourceId 필드명 변경       36  
개발 완료 /admin/reports/comments POST 부적절한 댓글 숨김 이하은             34  
개발 완료 /auth/verify-email POST 이메일 인증 코드 전송 김경래     @2025년 4월 29일 오후 9:00 이메일 인증 코드 전송으로 변경, 이메일 검증은 회원가입 API에서 함께 진행@2025년 5월 18일 오후 6:00 RequestParm 내용 기입       31  
개발 완료 /admin/reports/posts POST 부적절한 포스트 삭제 이하은             33  
개발 완료 /posts/{postId}/videos GET 포스트의 출처 유튜브 조회 (최대 10개) 이화영     [250508] sourceId 식별자 추가       35  
시작 전 /keywords/favorites/{keyword} POST 키워드 즐겨찾기 추가 (삭제)               29  
개발 완료 /comments/{commentId} DELETE 댓글 삭제 김하연     @2025년 4월 29일 오전 10:00 에러 코드(401 삭제 및 404 추가) 변경       30  
개발 완료 /posts/{postId} GET 포스트 조회 이태경     04월29일17시 - 400 코드를 404로 변경       32  
개발 완료 /reports/comments/{commentId} POST 댓글 신고 이하은     @2025년 5월 25일 etcReason 필드 추가       24  
시작 전 /keywords/favorites GET 즐겨찾기 키워드 조회 (삭제)               25  
시작 전 /analytics/{keyword}/timeline GET 키워드 타임라인 조회               27  
개발 완료 📃/auth/login POST 로그인 김경래     @2025년 4월 29일 오후 9:00 - 200 OK data값 수정@2025년 5월 8일 오후 5:00 - 401 Error 추가(메일 인증 되지 않은 회원)       26  
시작 전 /analytics/{keyword}/sentiment GET 키워드 감성 분석 조회               23  
개발 완료 /admin/reports/comments GET 신고된 댓글 조회 이하은             22  
시작 전 /subscriptions/{topic} POST 주간리포트 주제 구독 (삭제)               28  
개발 완료 /reports/posts/{postId} POST 포스트 신고 이하은     @2025년 5월 25일 etcReason 필드 추가       21  
개발 완료 /posts/{postId}/comments GET 댓글 목록 조회 김하연     [250429] request에 sort 추가, response에 id, createdAt 추가, 에러코드(404로) 변경[250506] 요청 method 정정(GET), sort 옵션 명시, response에 nickname 추가[250508] id → commentId 필드명 변경[250520] response에 profileUrl 추가       19  
개발 완료 /members/me GET 회원 정보 조회 김경래     @2025년 5월 4일 오후 7:00 Response Ok role 필드 추가@2025년 5월 8일 오후 11:00 Token 실패 에러 메세지 추가 및 변경       20  
개발 완료 /keywords/top GET 실시간 키워드 리스트 윤상민 , ,   [250429] 400 코드를 404로 변경[250508] volume 삭제       18  
개발 완료 /members/me DELETE 회원 탈퇴 김하연 ,           16  
시작 전 /keywords/favorites/{keyword} DELETE 즐겨찾기한 키워드 삭제 (삭제)               14  
개발 완료 /admin/members GET 회원 목록 조회 이하은     @2025년 5월 25일 오전 1:20 403권한 메시지 추가,@2025년 5월 26일 Request Body 삭제       13  
개발 완료 /posts/search GET 키워드 검색 윤상민 ,   @2025년 4월 30일 오전 11:39 response 수정 (기존 response와 통일성을 위해 list 수정), request sort 추가       17  
개발 완료 /comments/{commentId} PATCH 댓글 수정 김하연     @2025년 4월 29일 오전 10:00 response에 id, createdAt 추가, 에러 코드(401 삭제 및 404 추가) 변경 @2025년 5월 6일 오후 11:00 method 정정(PATCH)[250508] id → commentId 필드명 변경[250520] response에 profileUrl 추가       15  
개발 완료 /members/password PATCH 비밀번호 초기화 김경래             11  
개발 완료 📃/members/signup POST 회원가입 김경래     04월29일9시- 200 OK data값 수정@2025년 5월 4일 오후 7:00 엔드 포인트 auth/singup→ member/signup 으로 변경@2025년 5월 8일 오후 5:00 실패 response 수정, Conflict 409 중복된 이메일, 닉네임       8  
개발 완료 /posts/top GET 실시간 포스트 리스트 이태경     04월29일17시 - 400 코드를 404로 변경       10  
개발 완료 /members/me PATCH 회원 정보 수정 윤상민     @2025년 5월 26일 중복 예외처리 추가       12  
개발 완료 /auth/check-email POST 이메일 인증 김경래     @2025년 4월 29일 오후 9:00 GET→ POST로 수정       9  
개발 완료 /admin/reports/posts GET 신고된 포스트 조회 이하은             7  
개발 완료 /comments/{commentId}/like POST 댓글 추천 김하연     @2025년 4월 29일 오전 10:00 response에 id, createdAt 추가, 에러 코드(401 삭제 및 404 추가) 변경 @2025년 5월 6일 오후 11:00 response에 nickname 추가[250508] id → commentId 필드명 변경[250520] response에 profileUrl 추가       6  
개발 완료 /auth/refresh POST 토큰 갱신 김경래     @2025년 5월 1일 오전 1:00 Error 응답 코드 수정@2025년 5월 2일 오후 12:00 OK 응답 accessToken, refreshToken만 반환하도록 수정@2025년 5월 3일 오후 5:00 Token값 보안상의 이유로 쿠키로만 관리@2025년 5월 8일 오후 5:00 쿠키명 refresh_token→refreshToken으로 변경       4  
시작 전 /keywords/alerts POST 키워드에 대한 이슈 알림 (삭제)               5  
개발 완료 /auth/logout POST 로그아웃 김경래             3  
개발 완료 /posts/{postId}/comments POST 댓글 작성 김하연     [250429]response에 id, createdAt 추가, 에러 코드(401 삭제 및 404 추가) 변경[250506] response에 memberId, nickname 추가[250508] id → commentId 필드명 변경[250520] response에 profileUrl 추가       1  
개발 완료 /admin/members/{memberId} PATCH 악성 유저 차단 이하은             2