Status
GET https://api.amodb.dev/health retorna {"ok":true} quando a borda da API está no ar. Não precisa de chave e não conta na sua taxa. Erros 500 ou 504 repetidos em vários endpoints indicam um incidente. Relate-o a support@amodb.dev com o caminho da requisição, o horário em UTC e o status HTTP.
Endpoint de saúde
Use-o nas suas próprias verificações de disponibilidade. Não precisa de chave. Uma verificação a cada 60 segundos basta.
curl "https://api.amodb.dev/health"{ "ok": true }Sinais de um incidente
| O que você vê | Causa provável | O que fazer |
|---|---|---|
504 com status_code 24 em vários caminhos | O backend está lento ou fora do ar | Tente de novo com backoff; os caminhos em cache continuam funcionando |
500 com status_code 11 em vários caminhos | Um erro do nosso lado | Tente de novo após alguns segundos e relate se persistir |
429 com status_code 25 | Seu próprio limite de requisições | Não é um incidente; veja limites de requisições |
401 com status_code 7 | Chave ausente ou errada | Não é um incidente; veja autenticação |
Durante um incidente no backend, o cache de borda continua respondendo pelos caminhos que mantém: detalhes por até 6 horas, listas por 30 minutos e imagens por 30 dias.
Relatar um problema
Escreva para support@amodb.dev com:
- o caminho e a consulta da requisição, sem a sua chave
- o horário em UTC
- o status HTTP e o corpo da resposta
- os valores dos cabeçalhos
X-RateLimit-*, se houver
As mudanças planejadas e as correções estão listadas no histórico de alterações.