Skip to content

DEMOPhase 0 prototype. Stories, topics and numbers on this page are DEMO, made for visual review.

Eureka42
← Back to the documentation

Concepts · Version v0

Erros e limites

Como a API informa falhas (RFC 9457), quais códigos existem e como se recuperar de limites de uso.

This page is not translated into this language yet; showing it in Português.

Formato dos erros

Toda falha responde com content-type: application/problem+json (RFC 9457) e os campos type, title, status, instance e requestId. Erros de validação trazem também errors, com o campo e o motivo.

O campo type é uma URN estável, por exemplo urn:eureka42:problem:validation ou urn:eureka42:problem:not-found. Use o type no seu código; o title é texto para pessoas e pode mudar.

Códigos mais comuns na API pública

  • 400 com urn:eureka42:problem:validation: parâmetro inválido (por exemplo, locale desconhecido).
  • 404 com urn:eureka42:problem:not-found: item inexistente ou ainda não publicado.
  • 429 com urn:eureka42:problem:rate-limited: limite de uso atingido.

Limites e recuperação

A busca aceita 60 consultas por minuto por IP. Ao receber 429, espere o número de segundos do cabeçalho retry-after antes de tentar de novo; não repita em laço.

Guarde o requestId ao relatar um problema: ele identifica a requisição nos registros sem expor dados pessoais.

Idiomas

Os conteúdos existem em pt-BR, en-US e es-ES. Quando falta tradução de um item, a API devolve o texto disponível e informa o idioma real no campo locale da resposta.