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 headerx-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
Por exemplo, se seu plano permite 60 requisições/minuto, você pode fazer no máximo 15 requisições concorrentes (60 ÷ 4 = 15).
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:Boas Práticas
- Implemente retry com backoff exponencial: Se receber erro de rate limit (429), aguarde antes de tentar novamente
- Cache respostas quando possível: Evite requisições desnecessárias armazenando dados localmente
- Use webhooks: Configure webhooks para receber notificações em vez de fazer polling constante
- Otimize requisições em lote: Agrupe múltiplos registros em uma única chamada quando o endpoint suportar
- 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