오류 응답

형식

성공이 아닌 응답은 모두 같은 형태의 JSON 입니다.

{
  "error_code": "USER_SESSION_INVALID",
  "message": "세션 정보가 없습니다",
  "payload": {}
}json
필드 타입 설명
error_code string 오류 식별자. 분기 처리는 이 값으로 합니다
message string 사람이 읽는 한국어 안내. 문구는 바뀔 수 있으니 분기에 쓰지 마세요
payload object 오류별 추가 정보. 없으면 빠집니다
pg_error_code string 결제사 오류일 때만 있습니다

예상하지 못한 서버 오류는 500 과 "error_code": "SERVER_ERROR" 입니다.

HTTP 상태

HTTP 뜻
400 요청 값이 잘못됨
401 인증 실패·권한 없음·회원 세션 없음
403 이 리소스에 대한 권한 없음
404 대상이 없음. 다른 프로젝트의 리소스는 대부분 404 이지만 일부 API 는 401 로 거절합니다 — 각 문서의 오류 절을 봅니다
409 현재 상태와 충돌 (예: 이미 처리된 주문)
410 옮겨진 API 의 옛 주소
429 호출이 너무 잦음
442 처리할 수 없는 요청. 표준 422 가 아니라 442 를 씁니다
500 서버 오류

공통 오류

인증·scope·IP 오류는 인증에 정리돼 있습니다. 회원 전용 API 의 오류는 회원 JWT를 봅니다.

각 엔드포인트의 도메인 오류는 해당 문서의 오류 절에 있습니다.

함께 보기