Errors

공통 에러 포맷과 디버깅 체크리스트

공통 에러 포맷

GrowFit API는 에러 상황에서 다음과 같은 구조를 반환합니다.

{
  "error": {
    "code": "INVALID_ARGUMENT",
    "message": "필수 파라미터가 누락되었습니다.",
    "details": {
      "field": "project_id"
    }
  }
}

실제 필드 이름은 OpenAPI 스펙의 에러 응답 스키마를 기준으로 업데이트하세요.

---

자주 발생하는 에러

HTTP Status	예시	원인	대응
400 Bad Request	INVALID_ARGUMENT	필수 값 누락/타입 불일치	요청 스키마 확인
401 Unauthorized	UNAUTHORIZED	토큰 누락/만료	인증 헤더 확인
403 Forbidden	FORBIDDEN	권한 부족	권한 범위 확인
404 Not Found	NOT_FOUND	리소스 없음	ID 및 소유권 확인
409 Conflict	CONFLICT	중복 생성/상태 충돌	상태 확인 후 재요청
429 Too Many Requests	RATE_LIMITED	호출 제한	재시도/백오프
500 Internal Server Error	INTERNAL	서버 오류	로그 확인 및 재시도

---

디버깅 체크리스트

1. 요청 헤더: Authorization, Content-Type, Accept
2. 요청 바디: 필수 필드 누락 여부
3. 권한 범위: 엔드포인트 요구 권한과 일치 여부
4. 페이징/필터링: 파라미터 타입/범위 확인

---

프론트엔드 실수 예시

• 쿼리 파라미터 타입 오류: 숫자를 문자열로 전송
• 필수 필드 누락: project_id 또는 class_id 미전송
• 중복 요청: 빠른 연속 클릭으로 중복 생성