# API03005: Limite de Taxa Excedido

## O Que Isso Significa[​](#what-this-means "Link direto para O Que Isso Significa")

Você fez solicitações demais ao servidor em um curto período. O limite de taxa protege o servidor de ser sobrecarregado.

## Causas Comuns[​](#common-causes "Link direto para Causas Comuns")

* **Operações de sincronização rápidas** — Múltiplos dispositivos sincronizando simultaneamente
* **Atualização agressiva** — Atualizando dados com muita frequência
* **Plugin de segurança** — Um plugin está impondo limites de solicitações
* **Limites de hospedagem** — Seu plano de hospedagem tem limites de taxa da API

## Mapeamento de Erros do Servidor[​](#server-error-mapping "Link direto para Mapeamento de Erros do Servidor")

Este código de erro é acionado quando o servidor retorna:

| Código do Servidor | Fonte                                    |
| ------------------ | ---------------------------------------- |
| HTTP 429           | Qualquer resposta do servidor (fallback) |

## Como Corrigir[​](#how-to-fix "Link direto para Como Corrigir")

### 1. Aguarde e Tente Novamente[​](#1-wait-and-retry "Link direto para 1. Aguarde e Tente Novamente")

Os limites de taxa são temporários:

* Aguarde 1-5 minutos
* O POS irá automaticamente tentar novamente
* Evite atualizar manualmente repetidamente

### 2. Reduzir Operações Concorrentes[​](#2-reduce-concurrent-operations "Link direto para 2. Reduzir Operações Concorrentes")

Se estiver usando múltiplos terminais POS:

* Espalhe a sincronização inicial entre os dispositivos
* Evite atualizar todos os dispositivos ao mesmo tempo
* Deixe um completar antes de iniciar outro

### 3. Verifique os Plugins de Segurança[​](#3-check-security-plugins "Link direto para 3. Verifique os Plugins de Segurança")

Plugins como o Wordfence podem bloquear solicitações rápidas:

* Coloque o aplicativo POS na lista de permissões
* Coloque os IPs do seu dispositivo POS na lista de permissões
* Ajuste os limites de taxa

### 4. Revisar Limites de Hospedagem[​](#4-review-hosting-limits "Link direto para 4. Revisar Limites de Hospedagem")

Alguns provedores limitam as solicitações da API:

* Verifique os detalhes do seu plano de hospedagem
* Considere fazer upgrade se os limites forem muito baixos
* Entre em contato com o suporte a respeito do aumento dos limites

### 5. Otimize a Frequência de Sincronização[​](#5-optimise-sync-frequency "Link direto para 5. Otimize a Frequência de Sincronização")

Nas configurações do POS:

* Ajuste os intervalos de autoatualização
* Use a sincronização manual quando apropriado
* Evite atualizações desnecessárias de dados

## Erros Relacionados[​](#related-errors "Link direto para Erros Relacionados")

* [API03004](/pt-BR/error-codes/API03004.md) — Solicitação Muito Grande
* [API03007](/pt-BR/error-codes/API03007.md) — Fila de Solicitações Cheia

***