---
url: https://developers.zarv.com/api/id-v3/limits.md
description: >-
  Limite de taxa das rotas do Zarv ID v3: 50 requisições por segundo, rajada de
  100, e como tratar o 429.
---

# Limites de uso

As rotas do Zarv ID v3 aplicam um limite de taxa.

| Rotas                     | Limite                     | Rajada          |
| ------------------------- | -------------------------- | --------------- |
| `/api/v3/*`               | 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.

**Respeite o `Retry-After` no polling.** Enquanto um enriquecimento não termina,
a consulta devolve o cabeçalho `Retry-After` com quantos segundos esperar. Consultar
antes disso só gasta cota. Se puder, receba o resultado pelo
[callback](/api/id-v3/webhook) em vez de consultar.

**Reutilize o token de acesso.** Ele vale 6 minutos. Renove pelo
[endpoint de refresh](/api/id-v3/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.