🔌 FanPulse MVP API 명세서

대상: iOS / Android / Responsive Web 공통 버전: v1.0 (MVP)

1. 공통 규칙

1.1 Base URL

<https://api.fanpulse.app/api/v1>

1.2 인증

인증이 필요한 API는 🔒 표시
Header: Authorization: Bearer <access_token>
토큰 만료 시 401 응답 → 클라이언트에서 재로그인 유도

1.3 공통 Response 형식

성공 응답

{
  "success": true,
  "data": { ... }
}

에러 응답

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "사용자에게 표시할 메시지"
  }
}

1.4 HTTP 상태 코드

코드	설명
200	성공
201	생성 성공
400	잘못된 요청 (유효성 검사 실패)
401	인증 실패 (토큰 없음/만료)
403	권한 없음
404	리소스 없음
409	충돌 (중복 등)
500	서버 오류

1.5 에러 코드 목록

코드	HTTP	설명
`AUTH_INVALID_CREDENTIALS`	401	이메일/비밀번호 불일치
`AUTH_TOKEN_EXPIRED`	401	토큰 만료
`AUTH_TOKEN_INVALID`	401	유효하지 않은 토큰
`AUTH_EMAIL_EXISTS`	409	이미 가입된 이메일
`AUTH_GOOGLE_FAILED`	401	Google 토큰 검증 실패
`VALIDATION_ERROR`	400	입력값 유효성 검사 실패
`NOT_FOUND`	404	리소스를 찾을 수 없음
`SERVER_ERROR`	500	서버 내부 오류

1.6 페이지네이션