Rate Limiter

Limita quantas requisições cada cliente faz numa janela deslizante, com o estado no Redis. Todas as instâncias do serviço contam na mesma janela, então o limite configurado é o limite real, não N vezes ele. Use para proteger uma API contra abuso e dividir a capacidade entre clientes.

passos: 6
arquivos: 6
teste: 1
tecnologias: 5

Infraestrutura realTypeScriptBunElysiaRedisDocker

Cenário Relações Comparar

Baixar cartão

Cenário

Um banco digital expõe a API de transferências em duas instâncias atrás de um balanceador. Cada conta pode iniciar 3 transferências por segundo, somando as duas instâncias. A conta ACC-1001 dispara 6 transferências alternando as instâncias: as 3 primeiras passam e as 3 seguintes recebem 429. Um segundo depois, as entradas antigas saem da janela e a conta volta a transferir.

Planta

Sequência

8/8

8 passos — reproduza para seguir o fluxo

chamada
resposta ou assíncrono
falha
passo
toque num participante para focar
Outras plantas de sequência

Como funciona

6 passos

Token bucket limita requisições por janela.

Esconde cada passo: lembre antes de tocar para revelar.

Vocabulário compartilhado

Retry-After+3

01
Chave pela contaA rota é autenticada, então a chave é a conta (transfer:limit:v1:<conta>), nunca o IP
02
Janela deslizanteUm sorted set por conta, com o timestamp da requisição como score
03
Passo atômicoUm script Lua remove o que saiu da janela, conta e registra; duas instâncias nunca deixam passar a mesma vaga
04
Contrato da respostaRateLimit-Limit, RateLimit-Remaining e RateLimit-Reset em toda resposta; 429 com Retry-After quando nega
05
Recusa não contaRequisição negada não entra no sorted set, então martelar o limite não empurra a janela
06
Fail-closedTransferência é escrita; sem Redis, a API responde 503 em vez de liberar sem limite

apps/patterns/rate-limiter

6 arquivos

src/

limit_transfer.tsConexão ao Redis, script Lua da janela deslizante e cabeçalhos RateLimit-*
api_transfer.tsAPI Elysia de transferência com o limite por conta no onBeforeHandle
config_transfer.tsLê e valida o ambiente no boot
limit_transfer.test.tstesteIntegração contra Redis real: fronteira da cota e da janela, corrida entre instâncias, 429
demo.tsdemoSobe duas instâncias e alterna transferências entre elas