주요 콘텐츠로 건너뛰기

API 참조

오류 코드

오류 코드

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회 요청