API & Desenvolvedores
2 min de leituraAtualizado em 22 out. de 2026

Rate Limits

Trate limites de frequência por operação e diferencie quota de provedor de indisponibilidade transitória.

Abrir no app

Como usar

  1. Consulte limites e respostas da operação na referência atual.
  2. Para 429, use o prazo de repetição informado quando existir e evite requisições paralelas desnecessárias.
  3. Antes de repetir uma alteração/envio, confira se o efeito anterior foi confirmado ou permanece incerto.

Controle frequência sem duplicar efeitos

  • Para 429, observe a orientação de espera da resposta quando presente. Reduza paralelismo e respeite limites específicos da operação e do provedor.
  • Antes de repetir uma escrita, confira se o efeito foi confirmado, recusado ou permanece incerto. Uma leitura pode ser repetida de forma diferente de um envio ou cobrança.
  • Falta de autorização, quota e indisponibilidade não são a mesma causa; trate o motivo retornado em vez de repetir indefinidamente.

Como conferir o resultado

  • O cliente reduz frequência, preserva identidade da operação e não duplica efeitos externos.

Limites e cuidados

  • Limites não são um único número para toda API. Falta de saldo do provedor exige correção de quota; esperar indefinidamente não resolve.
  • Inscrição pública já cadastrada não é por si só um erro 429.

Se algo não funcionar

Esperar não resolveu a falha
Confira se a resposta aponta permissão ou quota, em vez de frequência transitória. Corrija essa condição antes de retentar.

Continuar no aplicativo

Este artigo resolveu sua dúvida?

Sua avaliação ajuda a priorizar revisões de conteúdo.