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

# Limites de Taxa da API e Boas Práticas

> O SpherePay impõe 100 RPS para leitura e escrita. Aprenda a tratar erros de limite de taxa, implementar retry e solicitar aumentos temporários.

O SpherePay impõe limites de taxa em todas as requisições de API para garantir confiabilidade e desempenho justo para todos os usuários. Entender esses limites e projetar sua integração em torno deles ajudará a evitar interrupções à medida que você escala.

## Limites de taxa padrão

O SpherePay mede os limites de taxa em requisições por segundo (RPS) por aplicação.

| Operação | Métodos HTTP             | Limite de taxa |
| -------- | ------------------------ | -------------- |
| Leitura  | GET                      | 100 RPS        |
| Escrita  | POST, PUT, PATCH, DELETE | 100 RPS        |

<Note>
  Se você tiver acordado limites personalizados com a equipe de suporte do SpherePay, seus limites de taxa podem ser diferentes dos padrões acima.
</Note>

## Solicitando um aumento de limite de taxa

Se seu caso de uso exigir limites mais altos — por exemplo, durante um lançamento de produto ou um evento de alto tráfego — entre em contato com [support@spherepay.co](mailto:support@spherepay.co) para solicitar um aumento temporário ou permanente.

## Testes de carga

Se você precisar realizar testes de carga nas APIs do SpherePay, simule requisições usando parâmetros de latência realistas em vez de throughput máximo. Para integrações complexas ou janelas dedicadas de teste de carga, entre em contato com [support@spherepay.co](mailto:support@spherepay.co) antes de executar os testes.

<Note>
  O SpherePay pode fornecer janelas designadas de teste de carga para integrações que as exijam. Entre em contato com a equipe de suporte para organizar isso com antecedência.
</Note>

## Boas práticas

Seguir estas diretrizes ajudará você a permanecer dentro dos limites de taxa e manter uma integração confiável:

* **Monitore o uso da API** — acompanhe suas taxas de requisição regularmente para identificar picos antes que causem erros.
* **Implemente exponential backoff** — ao receber um erro de limite de taxa, aguarde e tente novamente com atrasos crescentes. Consulte o [guia do padrão de Retry com Backoff da AWS](https://docs.aws.amazon.com/prescriptive-guidance/latest/cloud-design-patterns/retry-backoff.html) para uma implementação de referência.
* **Faça cache com eficiência** — armazene dados lidos com frequência localmente para reduzir requisições GET repetidas para os mesmos recursos.
* **Otimize requisições** — agrupe operações onde possível e solicite apenas os dados que sua aplicação realmente precisa.