NOTAS SOBRE PLANOS

Vivendo na cota REST leve do plano SSE

O lado REST do plano SSE é 20 por minuto, 100 por hora, 100 por dia. O que cabe dentro, o que nunca cabe, e como gastá-la sem um 429.

O plano de alertas SSE de quedas é um stream com um pequeno lado REST: 20 requisições por minuto, 100 por hora e 100 por dia, como o guia de planos os lista, verificado em 2026-10-14. Essa cota existe para consultas em torno dos seus alertas, não para polling. Viver bem com ela significa saber exatamente o que cabe e o que nunca caberá.

Para que serve a cota

O stream faz a vigia, então o REST nesse plano responde às perguntas que o stream levanta. Um snapshot do board para ver o contexto ao redor de um alerta, uma checagem de saúde do seu próprio pipeline, uma verificação ocasional de que o seu parser ainda lê o envelope. O guia de planos descreve a cota como suficiente para essas consultas e nada mais, e isso é preciso.

Um dia com esse orçamento é um punhado de leituras de board, não uma agenda.

O que nunca cabe

Qualquer coisa num timer. Um board a cada 15 minutos são 96 chamadas por dia, a cota diária inteira gasta num único poll lento, e a página da chave gratuita faz a mesma aritmética para o nível gratuito, verificado em 2026-10-14. Um loop de polling no plano SSE é um erro de plano, não um problema de ajuste: o próprio teste do guia de planos é que se o seu código começa a consultar boards numa agenda, ele cresceu além do plano.

Se você precisa de boards agendados, isso é o plano de snapshots REST ou o combinado, não uma gambiarra nessa cota.

Gaste deliberadamente

Três hábitos mantêm a cota leve útil. Roteie as consultas por necessidade, não por hábito: cada chamada REST deve responder a uma pergunta que um alerta específico levantou. Agrupe as perguntas: uma leitura de board pode resolver cinco alertas de uma vez se você agrupá-los primeiro. E observe a janela por hora, porque 100 por hora é o teto que morde depois de uma hora cheia de stream, quando cada alerta disparou uma consulta.

O teto por minuto quase nunca importa nesses volumes; ele existe para impedir que uma rajada gaste o dia em cinco minutos.

O sinal de upgrade

Você cresceu além da cota quando suas consultas começam a enfileirar: alertas esperando leituras de board porque a hora se gastou. Esse é o momento do plano combinado REST + SSE a US$ 149 por mês, que troca os tetos de calendário por uma taxa por segundo, conforme o guia de planos. Até lá, o lado REST leve é um dos melhores negócios da tabela de preços: um stream de quedas completo mais REST suficiente para respondê-lo.

Stream para os movimentos, REST para as perguntas que eles levantam, e nunca um timer. Essa é a cota inteira, gasta do jeito que foi dimensionada.