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

# Limites da API

> Entenda as restrições de requisições e quotas da API v2 baseadas no seu plano

## Visão Geral

A plataforma Olist implementa restrições de requisições baseadas no plano contratado. O limite exato aplicado à sua conta é comunicado através do header **`x-limit-api`** em cada resposta da API.

## Rate Limits por Plano

A tabela abaixo mostra os limites de requisições por minuto de acordo com cada plano:

| Plano         | Requisições/minuto | Serviços em lote |
| ------------- | ------------------ | ---------------- |
| Começar       | 0                  | 0                |
| Crescer       | 30                 | 5                |
| Evoluir       | 60                 | 5                |
| Potencializar | 120                | 5                |

### Planos Descontinuados

Para planos descontinuados (Free, Teen, Premium, Profissional):

* **Requisições por minuto**: 20
* **Serviços em lote**: 5

## Quotas de Registros

### Registros por Lote

* **Máximo por requisição em lote**: 20 registros

### Resultados por Chamada

* **Máximo de registros retornados**: 100 registros por consulta

### Requisições Concorrentes

* **Limite de requisições simultâneas**: 1/4 do limite total do plano

<Info>
  Por exemplo, se seu plano permite 60 requisições/minuto, você pode fazer no máximo 15 requisições concorrentes (60 ÷ 4 = 15).
</Info>

## Serviços Contabilizados como Lote

Independentemente da quantidade de registros enviados, os seguintes serviços são sempre contabilizados como **chamadas em lote**:

* **Contatos**: Incluir e Alterar
* **Grupos de Tags**: Incluir e Alterar
* **Tags**: Incluir e Alterar
* **Produtos**: Incluir e Alterar

## Verificando Seus Limites

Você pode verificar o limite aplicado à sua conta através do header de resposta:

```bash theme={null}
curl -I https://api.tiny.com.br/api2/info.php \
  -d "token=SEU_TOKEN&formato=json"
```

Procure pelo header:

```
x-limit-api: 60
```

## Boas Práticas

1. **Implemente retry com backoff exponencial**: Se receber erro de rate limit (429), aguarde antes de tentar novamente
2. **Cache respostas quando possível**: Evite requisições desnecessárias armazenando dados localmente
3. **Use webhooks**: Configure webhooks para receber notificações em vez de fazer polling constante
4. **Otimize requisições em lote**: Agrupe múltiplos registros em uma única chamada quando o endpoint suportar
5. **Monitore o header x-limit-api**: Acompanhe seu limite para ajustar a frequência de chamadas

## Erros de Rate Limit

Quando você exceder o limite de requisições, receberá uma resposta com:

* **Status HTTP**: 429 (Too Many Requests)
* **Mensagem**: Indicando que o limite foi excedido

Aguarde alguns segundos antes de fazer novas requisições.