Limites, idempotência e paginação

Quantas chamadas cabem por minuto, como repetir sem duplicar e como paginar listas.

https://leadgo.com.br/api/v1 Baixar arquivo para IA OpenAPI 3.1 Criar token

Limites

120 requisições por minuto por conta (todos os tokens somam). Os cabeçalhos X-RateLimit-Limit e X-RateLimit-Remaining mostram o saldo; ao passar, 429 com Retry-After.
Consultas novas à plataforma (buscas de cidade e interesse, métricas fora do cache): 10 por minuto por conta. Repetidas vêm do cache e não contam.
Até 5 campanhas publicando ao mesmo tempo e 30 criadas por hora por conta. A Meta bloqueia contas de anúncio que criam demais em pouco tempo.
Rascunho pela IA: o mesmo limite por hora do painel, por pessoa.
Sincronização manual: uma a cada 5 minutos.

Idempotência

Nas rotas que criam (POST /campaigns, /duplicate, /retry e /templates/{id}/campaigns), envie Idempotency-Key com um valor único por operação (um UUID). Repetir o mesmo pedido com a mesma chave, em até 24 h, devolve a primeira resposta com o cabeçalho Idempotent-Replayed: true, sem criar de novo.

Mesma chave com outro corpo: 422 idempotency_key_reused.
Enquanto o primeiro pedido ainda roda: 409 idempotency_in_progress (tente de novo em segundos).
Erros 5xx, 409 e 429 não ficam guardados: repetir com a mesma chave executa de novo.
Cada token tem as suas chaves.

Paginação

Listas longas (campanhas e mídias) são paginadas por cursor: siga links.next até ele vir null, ou envie ?cursor= com meta.next_cursor. Em /campaigns, limit vai de 1 a 100 (padrão 25).