오류 및 할당량

HTTP 상태와 안정적인 기계 판독 가능 코드로 Narwhal 문제를 처리하세요.

REST 오류는 다음을 사용합니다 application/problem+json MCP 도구 오류는 구조화된 콘텐츠에 동일한 문제 필드를 담습니다.

문제 응답

다음 기준으로 분기합니다 status 첫 번째 및 code 초입니다. 다음처럼 처리하세요 detail 안정적인 프로그래밍 값이 아닌 사람이 읽을 수 있는 진단 텍스트입니다.

RFC 9457 문제

{
  "ok": false,
  "type": "https://narwhalapi.com/problems/series-not-found",
  "title": "Economics series not found",
  "status": 404,
  "detail": "No approved economics observations matched the request.",
  "code": "series_not_found",
  "request_id": "019d1af4-8f33-7b21-91af-ef535f2dcf50",
  "instance": "/v1/economics/USA/cpi"
}

상태 및 코드

상태	공개 코드	의미
`400`	`invalid_query`	국가, 기간 또는 기타 요청 입력이 잘못되었습니다.
`401`	`invalid_api_key`	Bearer 키가 누락되었거나 형식이 잘못되었거나 알 수 없거나 비활성 상태입니다.
`404`	`series_not_found`	요청과 일치하는 승인된 최신 또는 과거 관측값이 없습니다.
`404`	`route_not_found`	요청한 REST 경로가 존재하지 않습니다.
`404`	`tool_not_found`	요청한 MCP 도구가 공개되지 않았거나 존재하지 않습니다.
`405`	`method_not_allowed`	경로는 존재하지만 요청한 HTTP 메서드를 허용하지 않습니다.
`429`	`rate_limit_exceeded`	네트워크 또는 계정 단기 제한에 도달했습니다. 다음 이후 재시도하세요 `Retry-After`.
`429`	`quota_exhausted`	계정이 월간 요청 허용량을 모두 사용했습니다.
`500`	`internal_error`	Narwhal이 요청을 완료하지 못했습니다.
`503`	`api_disabled`	공개 데이터 게이트가 일시적으로 닫혔습니다.
`503`	`economics_unavailable`	Narwhal은 승인된 공식 발표를 바탕으로 요청을 안전하게 처리할 수 없습니다.
`503`	`database_unavailable`	데이터 저장소를 일시적으로 이용할 수 없습니다.
`503`	`rights_state_changing`	Narwhal은 응답을 준비하는 동안 출처 권한이 변경되지 않았음을 확인하지 못했습니다.

할당량 헤더

성공한 각 데이터 응답은 할당량을 정확히 1회 소비하며 다음을 포함합니다

X-Request-IDX-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-ResetX-RateLimit-Short-LimitX-RateLimit-Short-RemainingX-RateLimit-Short-Reset

일반 헤더는 다음을 설명합니다 3,000-요청 UTC 월간 한도입니다. 인증된 응답에서 단기 구간 헤더는 Free 계정 한도를 나타냅니다: 30 분당 요청 수와 버스트 5 별도의 악용 방지 버킷은 하나의 네트워크 식별자에 대해 분당 120회, 버스트 20회를 허용합니다. 따라서 같은 주소를 공유하는 클라이언트는 함께 제한될 수 있습니다. 429 rate_limit_exceeded 포함합니다 Retry-After 제한 단기 구간에 대해; 다음 429 quota_exhausted 다음 UTC 달력 월을 기다립니다. 어느 응답도 월간 할당량을 소비하지 않습니다.

재시도 동작

재시도하지 마세요 400 요청이 수정될 때까지.
재시도하지 마세요 401 동일하게 거부된 키와 함께.
재시도 429 다음 이후에만 Retry-After 또는 X-RateLimit-Reset.
멱등 요청을 다음 이후에 재시도하세요 500 또는 503 제한된 지수 백오프와 지터를 사용합니다.
A 404 series_not_found 지원되는 공식 발표가 게시된 후에만 이용할 수 있게 될 수 있습니다.

도움 요청

엔드포인트, UTC 시각, 상태, 코드 및 다음을 보내세요 request_id 대상 Narwhal API 지원 API 키를 절대 포함하지 마십시오.

다음으로 돌아가기 빠른 시작 또는 다음을 검토합니다 Economics API 레퍼런스.