Overview
API 공통 규칙과 묶음 목록입니다.
어떤 API가 있고, 요청에 무엇을 담아 보내면 어떤 응답이 오는지 정리한 문서입니다. 현재 25개의 API가 있습니다.
Conventions
| 항목 | 규칙 |
|---|---|
| Base URL | /api |
| 인증 | Authorization: Bearer <access_token> |
| 본문 형식 | JSON (Content-Type: application/json) |
| 리프레시 토큰 | httpOnly 쿠키. 요청에 자동 포함 (withCredentials) |
| 오류 응답 | { "detail": "메시지" } |
| 요청 형식 오류 | 422 { "detail": [{ "loc": [...], "msg": "...", "type": "..." }] } |
| 시간 형식 | ISO 8601 (UTC), 예: 2026-10-05T09:00:00Z |
묶음
| 묶음 | 개수 | 설명 |
|---|---|---|
Health | 2개 | 서버가 살아 있는지, DB까지 준비됐는지 확인 |
Auth | 12개 | 회원가입, 로그인, 토큰 재발급, 이메일 인증, 비밀번호 찾기·재설정 |
Users · 내 정보 | 8개 | 내 정보 조회·수정, 비밀번호 변경, 탈퇴 |
Users · 관리자 | 5개 | 멤버 검색, 역할 변경, 활성/비활성, 삭제 (MASTER 전용) |
llm | 1개 |