Tema
API
Integrar e operar uma API de infraestrutura: erros HTTP, 429 e retentativa, versionamento, cache, chaves de acesso e webhooks.
17 artigos
Automatizar verificação por OTP em Node.js
O laço inteiro: pedir o número, esperar o código, encerrar o pedido. Com o try/catch que evita pedido pendurado e o erro que o tutorial feliz não mostra.
Equipe AltiviaCloud · 11 de setembro de 2026
Uma chave para tudo é uma chave para o estrago todo
Se esta chave vazar hoje, o que a pessoa consegue fazer? Separar produção de teste sozinho já elimina a maior parte dos incidentes, e leva uma tarde.
Equipe AltiviaCloud · 6 de setembro de 2026
O que cachear numa integração, e o que nunca
Catálogo sim, saldo nunca. Preço fica no meio: para exibir pode, para cobrar não — e é daí que sai a reclamação de cobrança diferente da tela.
Equipe AltiviaCloud · 6 de setembro de 2026
Versionar API sem quebrar quem já integrou
Adicionar valor novo a um campo fechado quebra, ainda que pareça adição. O que quebra, o que não quebra, e como depreciar sem derrubar cliente pago.
Equipe AltiviaCloud · 6 de setembro de 2026
O que registrar em log de integração, e o que nunca
Ou falta o que você precisa no incidente, ou sobra o que nunca deveria ter sido gravado. Mascarar em vez de omitir, e um teste rápido no log da semana.
Equipe AltiviaCloud · 6 de setembro de 2026
Erros HTTP em API de infraestrutura e o que fazer com cada um
Um guia de tradução: o que 400, 401, 409, 429 e 504 significam de verdade, quais merecem retentativa, e por que ramificar lógica pela mensagem em vez do código vira incidente.
Equipe AltiviaCloud · 5 de setembro de 2026
Timeout, retentativa e circuit breaker
fetch sem timeout espera para sempre e trava o seu sistema, não o do fornecedor. Quais falhas merecem retentativa, por que o jitter não é preciosismo e o que fazer com o circuito aberto.
Equipe AltiviaCloud · 5 de setembro de 2026
Rotacionar chave de API sem downtime
Revogar antes de trocar derruba a integração. A ordem que mantém duas chaves válidas por alguns minutos, o passo que todo mundo pula, e quando inverter tudo porque houve vazamento.
Equipe AltiviaCloud · 5 de setembro de 2026
SSE para eventos em tempo real, sem WebSocket
O servidor empurra evento pelo HTTP de sempre e o navegador já sabe receber. Onde o SSE ganha do polling, onde ele não serve, e os dois detalhes que só quebram em produção.
Equipe AltiviaCloud · 5 de setembro de 2026
Validar assinatura de webhook sem se enganar
Comparar com !== vaza o segredo pelo tempo de resposta, e reserializar o corpo antes do HMAC faz a assinatura nunca bater. Os dois modelos, os erros de cada um e três testes que provam que está de pé.
Equipe AltiviaCloud · 5 de setembro de 2026
Como monitorar uma integração de SMS em produção
Integração de SMS não cai, ela piora: continua respondendo 200 e entregando cada vez menos. A métrica que revela isso e os dois alertas que valem a pena.
Equipe AltiviaCloud · 5 de setembro de 2026
Idempotência em webhook de pagamento
Todo provedor entrega pelo menos uma vez, nenhum entrega exatamente uma vez. Por que a guarda óbvia não protege e como deixar o banco decidir quem credita.
Equipe AltiviaCloud · 5 de setembro de 2026
Onde a chave de API nunca pode estar
Repositório, navegador e arquivo de texto. Como rotacionar sem derrubar produção, e por que descobrir o caminho do vazamento é o passo que ninguém faz.
Equipe AltiviaCloud · 2 de setembro de 2026
429: como repetir sem piorar
Retentativa ingênua transforma uma requisição em três e mantém o limite estourado. Espera crescente, valor aleatório e o que nunca deve ser repetido.
Equipe AltiviaCloud · 2 de setembro de 2026
Dez erros comuns ao integrar uma API de SMS
Guardar o número como telefone do cliente, escolher o país pelo preço, confundir pedido criado com número pronto. Os erros que o caminho feliz esconde.
Equipe AltiviaCloud · 2 de setembro de 2026
Webhook ou consulta em laço: como esperar o SMS
Trinta requisições para receber um código, e vinte e nove dizem 'ainda nada'. Por que o laço não escala e quando SSE vence o webhook.
Equipe AltiviaCloud · 2 de setembro de 2026
Como receber SMS com um número virtual
O que acontece entre comprar o número e o código chegar, como escolher o país certo e por que consultar em laço é a pior das três formas de esperar o SMS.
Equipe AltiviaCloud · 1 de setembro de 2026