---
url: https://developers.zarv.com/api/limits.md
---
# Limites de uso

As rotas de verificação aplicam um limite de taxa **por workspace**.

| Rotas                     | Limite                     | Rajada          |
| ------------------------- | -------------------------- | --------------- |
| `/api/v2/verifications/*` | 50 requisições por segundo | 100 requisições |

O **limite** é a taxa sustentada: 50 requisições a cada segundo, continuamente. A
**rajada** é quanto você pode disparar de uma vez, partindo do repouso — até 100
requisições simultâneas passam, e a partir daí a taxa volta a valer.

## O limite é por workspace

A contagem usa o workspace do seu token, e não o endereço IP nem o usuário. Duas
consequências:

* **Todas as suas máquinas compartilham a mesma cota.** Se você roda a integração
  em vários servidores, some o tráfego de todos.
* **O consumo de um cliente não afeta o de outro.** Cada workspace tem sua
  própria cota.

## O que você recebe ao exceder

Status **429 Too Many Requests**. A requisição não é processada nem cobrada.

Não há bloqueio nem punição: assim que a taxa cair, as requisições voltam a
passar no mesmo instante.

## Como trabalhar dentro do limite

**Trate o 429 com espera crescente.** Ao receber 429, espere antes de tentar de
novo, dobrando o intervalo a cada nova falha (por exemplo 1s, 2s, 4s, 8s).
Repetir imediatamente não adianta.

**Use o endpoint de lote para volume.** Para verificar muitos documentos, prefira
[`POST /api/v2/verifications/batch`](/api/zarv-id/) a disparar uma requisição por
documento.

**Reutilize o token de acesso.** Ele vale 6 minutos. Renove pelo
[endpoint de refresh](/api/zarv-id/authentication#renovando-um-token-de-acesso)
em vez de reenviar usuário e senha a cada chamada.

**Webhooks não contam.** Os callbacks que a Zarv envia ao seu endpoint não
passam por esse limite — ele vale só para as requisições que você faz à API.

## Se o seu volume for maior

50 requisições por segundo atendem com folga o uso normal. Se a sua integração
precisar de mais, fale com o time da Zarv antes de subir o volume em produção.