Limites de requisição

#Taxa de requisições

A API limita o número de requisições por janela de um minuto:

Emitir mais chaves não aumenta o limite da conta. Os valores podem ser ajustados pela Koku; não dependa de um número fixo e trate a resposta 429.

As respostas trazem os cabeçalhos x-ratelimit-limit, x-ratelimit-remaining e x-ratelimit-reset (segundos até a janela reiniciar).

#Ao passar do limite (429)

A API responde 429 rate_limited com o cabeçalho Retry-After:

{
  "error": {
    "code": "rate_limited",
    "message": "Limite de requisições excedido. Aguarde antes de tentar de novo.",
    "details": {
      "retry_after_seconds": 42
    },
    "correlation_id": "9d2c6e18-3a7f-4b50-8e91-f4b0a2c7d635"
  }
}

Espere o número de segundos de Retry-After antes de repetir. Para mutações, repita com a mesma Idempotency-Key.

#Como gastar menos

• Use webhooks em vez de consultar em laço. Se precisar consultar, espere alguns segundos entre as consultas.
• Pagine com limit maior em vez de muitas páginas pequenas.
• Guarde em cache o que não muda (por exemplo, os tipos de evento).

#Outros limites