Erros e limites de requisições
Formato de erro da AdLib, códigos de erro, limites de requisições por minuto em cada plano, headers de limite e como tentar de novo.
Formato de erro
Os erros devolvem um corpo JSON com um código legível por máquina:
{
"error": {
"code": "not_found",
"message": "ad meta:123 not found",
"request_id": "c821fd4d-699b-4080-9776-841f4b57aad2",
"billed": false
}
}Erros nunca são cobrados. Informe o request_id (que também vem no header X-Request-Id) quando falar com a gente.
Códigos
| Código | Significado | O que fazer |
|---|---|---|
bad_request |
Um parâmetro está faltando ou é inválido; details diz qual |
Corrija a requisição |
invalid_cursor |
O cursor não veio de um next_cursor |
Devolva o next_cursor sem alterar |
invalid_webhook_url |
A URL do webhook não é um endereço http(s) público (localhost, hosts privados, link-local e internos são recusados) | Use uma URL acessível pela internet |
interval_too_short |
interval_hours está abaixo do que sua conta permite (24 com os créditos gratuitos, 6 depois de comprar um pacote) |
Aumente interval_hours ou compre um pacote |
watchlist_too_large |
As listas de monitoramento passariam do número de marcas que sua conta permite (3 com os créditos gratuitos, 250 depois de um pacote) | Remova marcas ou compre um pacote |
batch_too_large |
Mais itens num lote do que sua conta permite (10 com os créditos gratuitos, 100 depois de um pacote) | Divida o lote |
unauthorized |
Chave de API ausente ou inválida | Confira o header X-API-Key |
account_blocked |
A conta está bloqueada | Fale com a gente |
history_limit |
O anúncio é mais antigo que o arquivo da sua conta (12 meses com os créditos gratuitos) | Compre um pacote para ter o arquivo completo |
not_found |
O anúncio, anunciante, job ou endpoint não existe | Confira o id ou o caminho |
rate_limited |
Passou das requisições por minuto da sua conta (30 com os créditos gratuitos, 300 depois de um pacote) | Espere os segundos de Retry-After |
quota_exceeded |
Créditos gratuitos e pacotes esgotados | Compre um pacote; não tente de novo |
upstream_error |
A biblioteca da plataforma falhou ou bloqueou a requisição | Tente mais tarde; confira o status |
internal_error |
Falha do nosso lado | Tente de novo; avise a gente se continuar |
Limites de requisições
| Conta | Requisições por minuto |
|---|---|
| Com os créditos gratuitos | 30 |
| Depois do primeiro pacote de créditos | 300 |
Toda resposta traz X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset (segundos até a janela reiniciar). Acima do limite, a API responde 429 rate_limited com um header Retry-After.
Novas tentativas
Tente de novo, com backoff, em rate_limited, upstream_error e internal_error. Não tente de novo em bad_request, unauthorized, not_found ou quota_exceeded. As plataformas às vezes mudam suas bibliotecas sem aviso; quando uma quebra, as chamadas para ela falham rápido, não são cobradas e aparecem na página de status.