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.
O que é limitado
Seção intitulada “O que é limitado”| Limite | Contagens | Objetivo |
|---|---|---|
| Por endereço IP | Toda solicitação proveniente de um endereço, esteja ele conectado ou não | Proteção contra abusos; a camada mais baixa |
| Por API chave | Solicitações feitas com uma APIchave de projeto | Evite que uma integração ou chave vazada sobrecarregue as demais |
| Por organização | Solicitações de todas as chaves e sessões de console de uma organização RTC | Distribuiçã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).
Cabeçalhos
Seção intitulada “Cabeçalhos”Respostas autenticadas contêm o estado do limite mais restritivo aplicável:
| Cabeçalho | Significado |
|---|---|
X-RateLimit-Limit | Solicitações permitidas na janela atual |
X-RateLimit-Remaining | Solicitações remanescentes na janela atual |
X-RateLimit-Reset | Segundos 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 RequestsRetry-After: 12X-RateLimit-Limit: 600X-RateLimit-Remaining: 0X-RateLimit-Reset: 12X-Error-Code: RATE_LIMITEDX-Request-Id: 6f1c2b8e-1d2a-4c55-9a8e-0f4b9b1d7c21Os números acima são meramente ilustrativos.
Aplique o backoff corretamente
Seção intitulada “Aplique o backoff corretamente”- Em
429, aguarde pelo menosRetry-Aftersegundos 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
?limite?cursorpara percorrer as listas em vez de repetir solicitações completas da lista.