Rate limiting

A API aceita um número máximo de requisições por janela de tempo. Esse limite — o rate limiting — protege a plataforma de excessos, como uma integração presa num laço que dispara milhares de chamadas.

Ver os limites

Os limites aparecem na aba Limites de Requisição de Sistema › API (/dashboard/api?tab=rate-limits).

Ao lado do status (Ativo ou Desativado), a tela diz se a organização usa a Configuração padrão da plataforma ou uma Configuração personalizada. Os limites vêm em três grupos:

Grupo	O que conta	Padrão da plataforma
Requisições GET	Leituras	200 por minuto e 5.000 por hora
Requisições de Escrita	POST, PUT, PATCH e DELETE	60 por minuto e 1.000 por hora
Burst	Picos curtos de requisições	20 requisições em 5 segundos

Precisa de limites diferentes? Fale com o suporte da Kobana: os limites de cada organização são ajustados pela equipe da Kobana, não pelo dashboard.

Quando o limite é excedido

A API responde 429 Too Many Requests, com o header Retry-After dizendo quantos segundos esperar. O corpo traz o mesmo valor em retry_after:

{
  "error": { "code": "TOO_MANY_REQUESTS", "message": "Rate limit exceeded" },
  "retry_after": 42
}

Para lidar bem com isso na sua integração:

1. Ao receber 429, espere os segundos de Retry-After antes de tentar de novo.
2. Não repita a chamada em laço imediato: as tentativas recusadas também contam e só prolongam o bloqueio.
3. Espalhe as chamadas grandes no tempo — por exemplo, use a paginação da API em vez de muitas buscas paralelas.

Cada token tem a própria contagem: o excesso de uma integração não consome o limite das outras. Mais detalhes na referência da API.