Conceptos · Versión v0
Erros e limites
Como a API informa falhas (RFC 9457), quais códigos existem e como se recuperar de limites de uso.
Esta página aún no está traducida a este idioma; se muestra en 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,localedesconhecido). - 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.