Docs

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:

JSON
{
  "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.