API Specification - polynomeer/preptide GitHub Wiki

🌐 API 명세서 (RESTful)

📌 인증

POST /api/auth/login

• 요청: { email, oauthProviderToken }
• 응답: { accessToken, refreshToken, userInfo }

📌 질문

GET /api/questions/daily

• 설명: 오늘의 질문 조회
• 응답: { id, content, tags, difficulty }

GET /api/questions/{id}

• 설명: 특정 질문 상세 조회
• 응답: { id, content, tags, difficulty, source }

📌 답변

POST /api/answers

• 요청: { questionId, content }
• 응답: { answerId, createdAt }

GET /api/answers/{id}

• 응답: { content, createdAt, aiFeedback, followUps[] }

📌 AI 피드백

GET /api/answers/{id}/feedback

• 설명: AI 피드백 단건 조회
• 응답: { logicalScore, structureScore, detailScore, comment }

📌 꼬리질문

GET /api/answers/{id}/followups

• 응답: [ { step, questionText } ]

📌 커뮤니티

GET /api/community/answers

• 설명: 공개 답변 목록 조회 (탐색 피드)
• 쿼리: ?tag=Java&sort=recent
• 응답: 리스트 형태

POST /api/answers/{id}/like

• 설명: 좋아요 등록
• 응답: { success: true }

POST /api/answers/{id}/comments

• 요청: { content }
• 응답: { commentId, createdAt }

POST /api/answers/{id}/remix

• 요청: { content }
• 응답: { remixId }

📌 숏폼 콘텐츠

GET /api/shorts

• 설명: 숏폼 콘텐츠 조회
• 응답: [ { id, title, url, tags[] } ]

📌 북마크

POST /api/bookmarks

• 요청: { questionId }
• 응답: { success: true }

GET /api/bookmarks

• 응답: [ { questionId, content, tags } ]