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

# Limites de uso

> Quantas chamadas cada chave pode fazer e como reagir ao limite.

## Limites por chave

Os limites valem por chave de API, em uma janela deslizante de 1 minuto.

| Tipo | Chamadas | Quais |
| - | - | - |
| Leitura | 600 por minuto | `GET` (catálogo, cota, lista, detalhe e PDF), `GET /webhook-endpoints` e `GET /webhook-endpoints/{id}/deliveries` |
| Escrita | 60 por minuto | `POST /uploads`, `POST /pretests`, `POST /webhook-endpoints`, `DELETE /webhook-endpoints/{id}` e `POST /webhook-endpoints/{id}/test` |

## Cabeçalhos

Toda resposta autenticada traz:

| Cabeçalho | Significado |
| - | - |
| `RateLimit-Limit` | Limite do tipo de chamada. |
| `RateLimit-Remaining` | Chamadas que ainda restam na janela. |
| `RateLimit-Reset` | Segundos até a janela liberar mais chamadas. |
| `Retry-After` | Só no `429`: segundos para esperar antes de tentar de novo. |

Toda resposta, com sucesso ou erro, traz `X-Request-Id`. Cite esse valor ao falar com o suporte.

## Ao receber 429

Há dois casos, ambos com `Retry-After`:

* [`rate_limited`](https://docs.myunite.ai/errors#rate_limited): a chave passou do limite por minuto.
* [`concurrency_limit`](https://docs.myunite.ai/errors#concurrency_limit): o workspace já tem pré-testes demais em andamento (cerca de 10 criados pela API). Espere algum terminar.

Espere o intervalo de `Retry-After` e tente de novo. Se for criação, reutilize a mesma `Idempotency-Key` ([Idempotência](https://docs.myunite.ai/idempotency.md)).

```bash curl theme={null}
curl -i https://myunite.ai/api/v1/quota \
  -H "Authorization: Bearer $UNITE_API_KEY"
```

```javascript JavaScript theme={null}
async function getWithRetry(url, tries = 5) {
  for (let i = 0; i < tries; i++) {
    const res = await fetch(url, {
      headers: { Authorization: `Bearer ${process.env.UNITE_API_KEY}` },
    });
    if (res.status !== 429) return res;
    const wait = Number(res.headers.get("Retry-After") ?? "1");
    await new Promise((r) => setTimeout(r, wait * 1000));
  }
  throw new Error("Limite de uso: tentativas esgotadas");
}

const res = await getWithRetry("https://myunite.ai/api/v1/quota");
console.log(res.headers.get("RateLimit-Remaining"));
```

```python Python theme={null}
import os
import time
import requests

def get_with_retry(url, tries=5):
    for _ in range(tries):
        res = requests.get(
            url,
            headers={"Authorization": f"Bearer {os.environ['UNITE_API_KEY']}"},
        )
        if res.status_code != 429:
            return res
        time.sleep(int(res.headers.get("Retry-After", "1")))
    raise RuntimeError("Limite de uso: tentativas esgotadas")

res = get_with_retry("https://myunite.ai/api/v1/quota")
print(res.headers.get("RateLimit-Remaining"))
```

## Boas práticas

* Consulte o status de um pré-teste a cada 10 segundos ou mais, não em laço apertado.
* Para muitos pré-testes, use a lista (`GET /pretests`) em vez de consultar um por um.
* Espalhe as criações no tempo: o limite de escrita é de 60 por minuto.


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