API documentation

Rate limits

Para garantir disponibilidade para todos, a API impõe limites de requisição por project.

Limites por plano

Headers de resposta

Toda resposta inclui headers indicando o status do rate limit:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1715865600

• Limit: limite por segundo do plano
• Remaining: requisições restantes na janela atual
• Reset: timestamp Unix de quando a janela reseta

Quando o limite é atingido

A resposta vem com HTTP 429 Too Many Requests e o header Retry-After indicando quantos segundos esperar:

HTTP/1.1 429 Too Many Requests
Retry-After: 1
Content-Type: application/json

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded. Try again in 1 second.",
    "request_id": "req_..."
  }
}

Excedente

Requisições além do limite mensal incluído no plano são cobradas a R$ 10,00 por 1.000 requisições adicionais, no fechamento do ciclo. Você pode definir um teto de excedente no Console.