오류 코드
MenuGaze API 엔드포인트는 표준 HTTP 상태 코드를 반환합니다. 오류 응답에는 무엇이 잘못되었는지에 대한 세부 정보가 담긴 JSON 본문이 포함됩니다.
오류 응답 형식
{
"success": false,
"error": "Human-readable error message"
}
상태 코드
| 코드 | 의미 | 일반적인 원인 |
|---|---|---|
200 |
OK | 요청이 성공했습니다. 응답 본문에 요청한 데이터가 포함됩니다. |
201 |
Created | 리소스가 성공적으로 생성되었습니다. POST 엔드포인트가 성공 시 반환합니다. |
400 |
Bad Request | 요청 본문에 필드가 누락되었거나 유효하지 않습니다. 모든 필수 필드가 있고 형식이 올바른지 확인하세요. |
401 |
Unauthorized | 인증 토큰이 없거나 유효하지 않습니다. Authorization 헤더에 유효한 Bearer 토큰을 포함했는지 확인하세요. 토큰이 만료되었을 수 있으니 다시 로그인하여 새 토큰을 발급받으세요. |
403 |
Forbidden | 인증은 되었지만 이 리소스에 접근할 권한이 없습니다. 일반적으로 다른 레스토랑에 속한 리소스에 접근하거나 수정하려고 할 때 발생합니다. |
404 |
Not Found | 요청한 리소스가 존재하지 않습니다. URL 경로의 ID가 올바른지 확인하세요. |
429 |
Too Many Requests | 속도 제한을 초과했습니다. 다시 시도하기 전에 기다려야 하는 초는 Retry-After 헤더에서 확인하세요. 인증 엔드포인트는 IP당 15분에 10회 요청으로 제한됩니다. 주문 생성은 IP당 분당 5회 요청으로 제한됩니다. |
500 |
Internal Server Error | 서버에서 예기치 않은 오류가 발생했습니다. 문제가 계속되면 지원팀에 문의하세요. 이러한 오류는 조사를 위해 자동으로 기록됩니다. |
503 |
Service Unavailable | 서비스를 일시적으로 사용할 수 없습니다. 유지 보수 중이거나 필요한 외부 서비스(예: 워커 시크릿)가 구성되지 않은 경우 발생할 수 있습니다. 잠시 후 다시 시도하세요. |
속도 제한
속도 제한이 있는 엔드포인트는 제한을 초과하면 429 상태를
반환합니다. 응답에는 다음이 포함됩니다.
-
Retry-After헤더 — 다음 요청을 보내기 전에 기다려야 하는 초입니다. - 초과된 속도 제한을 알리는 오류 메시지.
속도 제한은 IP 주소별로 적용됩니다. 현재 제한은 다음과 같습니다.
| 엔드포인트 | 제한 |
|---|---|
| 로그인 및 가입 | IP당 15분에 10회 요청 |
| 주문 생성 | IP당 분당 5회 요청 |
| 관련 항목 | IP당 분당 30회 요청 |