Pular para o conteúdo
Documentation

Limites de taxa do RTC

O RTC API limita o número de solicitações que aceita em um intervalo de tempo. Esses limites protegem as salas de todos os clientes contra um único cliente descontrolado; eles não são um medidor de cobrança.

LimiteContagensObjetivo
Por endereço IPToda solicitação proveniente de um endereço, esteja ele conectado ou nãoProteção contra abusos; a camada mais baixa
Por API chaveSolicitações feitas com uma APIchave de projetoEvite que uma integração ou chave vazada sobrecarregue as demais
Por organizaçãoSolicitações de todas as chaves e sessões de console de uma organização RTCDistribuição justa entre os clientes

Uma solicitação deve respeitar todos os limites que se aplicam a ela. Os limites por chave e por organização dependem do seu plano, e CHAMPREP você pode ajustá-los para uma organização. Leia os cabeçalhos abaixo em vez de codificar números diretamente.

Algumas operações possuem seus próprios limites mais restritos, que são indicados por um código específico, por exemplo, repetições de webhooks (REPLAY_QUOTA) e mensagens do aplicativo na sala (MESSAGE_RATE_LIMITED).

Respostas autenticadas contêm o estado do limite mais restritivo aplicável:

CabeçalhoSignificado
X-RateLimit-LimitSolicitações permitidas na janela atual
X-RateLimit-RemainingSolicitações remanescentes na janela atual
X-RateLimit-ResetSegundos até a reinicialização da janela

Uma solicitação que exceda o limite gera uma resposta 429 com o código RATE_LIMITED e um Retry-After cabeçalho, em segundos.

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
X-Error-Code: RATE_LIMITED
X-Request-Id: 6f1c2b8e-1d2a-4c55-9a8e-0f4b9b1d7c21

Os números acima são meramente ilustrativos.

  • Em 429, aguarde pelo menos Retry-After segundos antes da próxima solicitação e, em seguida, retome gradualmente. Não repita a tentativa em um loop contínuo.
  • Distribua as tarefas periódicas (polling, reconciliação) ao longo do tempo e dê preferência a webhooks em vez de polling.
  • Utilize uma APIchave por integração: seu próprio limite conterá uma tarefa descontrolada, e você poderá revogar uma chave sem afetar as demais.
  • Gere as credenciais dos participantes quando um usuário realmente ingressar, e não antecipadamente. Para grandes volumes de adesões, gerar tokens de adesão offline com uma chave de assinatura do projeto.
  • Utilize ?limit e ?cursor para percorrer as listas em vez de repetir solicitações completas da lista.