> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getqr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Limites de requisições

> Quantas requisições você pode enviar e como tratar respostas 429.

> [!NOTE]
>
> A API do GetQR está em beta e disponível para workspaces selecionados. Os detalhes podem mudar antes do lançamento oficial.

A API do GetQR limita quantas requisições cada chave de API pode enviar, para que uma única integração não deixe a API lenta para todos.

## Limites

| Limite | Valor |
| - | - |
| Requisições por chave de API | 600 por minuto |

O limite é contado em uma janela deslizante de um minuto e vale para todos os endpoints juntos. A [verificação de status](https://docs.getqr.com/pt-br/api/endpoints/health.md) não precisa de chave e não conta.

## Cabeçalhos de limite

As respostas a requisições com uma chave de API válida trazem estes cabeçalhos, inclusive as respostas de erro:

| Cabeçalho | Descrição |
| - | - |
| `X-RateLimit-Limit` | Número máximo de requisições por janela. |
| `X-RateLimit-Remaining` | Requisições restantes na janela atual. |
| `X-RateLimit-Reset` | Quando a janela é reiniciada, como timestamp Unix em milissegundos. |
| `Retry-After` | Segundos até a janela ser reiniciada, arredondados para cima. Aguarde esse tempo antes de tentar de novo. |

## Quando você ultrapassa o limite

Acima do limite, a API responde `429` com o código `rate_limit_exceeded` e os mesmos cabeçalhos:

```http theme={null}
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1792764060000
Retry-After: 37

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests.",
    "doc_url": "https://getqr.com/account/api-docs#error-rate_limit_exceeded"
  }
}
```

Aguarde o horário de reinício antes de enviar mais requisições. Adicione jitter para que vários workers não tentem de novo no mesmo instante, e use backoff exponencial em erros `5xx`:

```javascript theme={null}
async function getqrFetch(url, options = {}, maxRetries = 5) {
  for (let attempt = 0; ; attempt++) {
    const res = await fetch(url, {
      ...options,
      headers: {
        Authorization: `Bearer ${process.env.GETQR_API_KEY}`,
        ...options.headers,
      },
    });

    const retryable = res.status === 429 || res.status >= 500;
    if (!retryable || attempt >= maxRetries) return res;

    // On 429, wait for Retry-After (seconds). Otherwise back off: 1s, 2s, 4s…
    const retryAfter = Number(res.headers.get("Retry-After"));
    const wait =
      res.status === 429 && retryAfter > 0
        ? retryAfter * 1000
        : 1000 * 2 ** attempt;
    const jitter = Math.random() * 250;

    await new Promise((r) => setTimeout(r, wait + jitter));
  }
}
```

> [!TIP]
>
> Só repita `POST /api/v1/qrs` com um cabeçalho `Idempotency-Key`. Assim, uma nova tentativa nunca cria um segundo QR code. Veja [Idempotência](https://docs.getqr.com/pt-br/api/introduction.md#idempotência).

## Fique abaixo do limite

* Acompanhe `X-RateLimit-Remaining` e reduza o ritmo antes que chegue a 0.
* Use a [criação de QR codes em massa](https://docs.getqr.com/pt-br/api/endpoints/bulk-qr-creations.md) em vez de uma requisição por QR code.
* Busque até 100 resultados por página com `pageSize=100`. Veja [Paginação](https://docs.getqr.com/pt-br/api/introduction.md#paginação).
* Faça cache das imagens de QR: os downloads retornam um `ETag`, então você pode enviar `If-None-Match` e receber `304 Not Modified` quando nada mudou.

## Próximos passos

> [card] [Erros](https://docs.getqr.com/pt-br/api/errors.md)

> [card] [QR codes](https://docs.getqr.com/pt-br/api/endpoints/qr-codes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.