형식
성공이 아닌 응답은 모두 같은 형태의 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를 봅니다.
각 엔드포인트의 도메인 오류는 해당 문서의 오류 절에 있습니다.

