Webhooks explicados: Como funcionam e como recebê-los com segurança
Os webhooks permitem que um sistema informe outro no momento em que algo acontece, enviando uma solicitação HTTP para um URL de sua escolha. Aprenda como eles diferem das pesquisas, como verificar assinaturas e como sobreviver a novas tentativas e repetições com um receptor que executamos.
- Webhooks são solicitações HTTP POST que um provedor envia para seu URL quando um evento acontece, para que você não precise ficar perguntando.
- Qualquer pessoa pode chamar um URL público, então verifique uma assinatura HMAC no corpo bruto com uma comparação de tempo constante.
- Rejeite carimbos de data/hora antigos para interromper replays e armazene IDs de eventos para que as tentativas de entrega sejam processadas apenas uma vez.
- Em nossa execução, o receptor aceitou um evento válido, ignorou sua nova tentativa e rejeitou um corpo adulterado, um segredo errado e um replay de 10 minutos atrás.
Seu aplicativo precisa saber quando um pagamento foi bem-sucedido, uma compilação foi concluída ou um formulário foi enviado em outro serviço. Você poderia perguntar a esse serviço a cada minuto “alguma novidade?”, mas a maioria das respostas seria “não”. Webhooks mudam de direção: você fornece um URL ao serviço e ele liga para você no momento em que o evento acontece.
Para testar as ideias, em vez de apenas descrevê-las, escrevemos um pequeno receptor e remetente de webhook com a biblioteca padrão do Python 3.13, rodamos ambos em uma máquina e disparamos solicitações válidas, adulteradas, reproduzidas e repetidas. Os resultados abaixo são copiados dessa execução. Se as APIs em geral são novas para você, leia primeiro o que é uma API.
O que é um webhook?
Um webhook é um retorno de chamada HTTP. Você registra um endpoint, como https://example.com/hooks/payments, com um provedor e escolhe quais eventos são importantes para você. Quando isso acontece, o provedor envia uma solicitação POST para esse URL com um corpo JSON descrevendo o evento. Seu servidor lê, verifica se é genuíno, faz seu trabalho e responde com um código de status 2xx.
As pessoas às vezes chamam os webhooks de “APIs reversas”. Com uma chamada de API normal, seu código pergunta e o provedor responde. Com um webhook, o provedor inicia a conversa.
Webhooks vs pesquisas
| Aspecto | Pesquisando uma API | Webhooks |
|---|---|---|
| Quem começa | Seu aplicativo, em um cronômetro | O provedor, em cada evento |
| Atraso | Até um intervalo de pesquisa | Geralmente segundos |
| Chamadas desperdiçadas | Muitas respostas vazias | Quase nenhum |
| Seu servidor precisa | Somente acesso de saída | Um endpoint HTTPS público |
| Eventos perdidos | Raro; você pergunta de novo | Possível se as tentativas acabarem |
A pesquisa também ultrapassa os limites de taxa, conforme explica nosso guia de limitação de taxa de API. Muitas equipes usam ambos: webhooks para maior velocidade, além de uma verificação periódica que detecta qualquer coisa perdida em uma entrega com falha.
Como funciona uma entrega de webhook
- Um evento acontece no provedor, como
payment.succeeded. - O provedor cria uma carga JSON, assina-a com um segredo compartilhado apenas com você e envia-a para seu URL.
- Seu endpoint verifica a assinatura e o carimbo de data/hora, registra o ID do evento e retorna 200 rapidamente.
- Se o seu endpoint falhar ou expirar, o provedor tentará novamente mais tarde, geralmente com lacunas crescentes.
Qual é a aparência de uma carga útil
POST /hook HTTP/1.1
Content-Type: application/json
X-Timestamp: 1794500000
X-Signature: b82128c3c09fb40a...
{"id": "evt_1", "type": "payment.succeeded", "amount": 500}
Os valores de carimbo de data/hora e assinatura acima são ilustrações abreviadas. Os nomes de cabeçalho variam de acordo com o provedor, mas a maioria envia um ID de evento, um tipo de evento, um carimbo de data/hora e uma assinatura. Nosso guia Python JSON aborda a análise do corpo com segurança.
Assinando e verificando solicitações
O URL do seu webhook é público, então qualquer pessoa que souber dele poderá enviar eventos falsos, como um falso “pagamento bem-sucedido”. A defesa padrão é uma assinatura HMAC. O provedor calcula um HMAC SHA-256 do carimbo de data/hora e do corpo bruto usando um segredo compartilhado, e você o recalcula do seu lado:
import hmac, hashlib, time
SECRET = b"whsec_demo_only" # load from an environment variable in real code
def sign(body: bytes, ts: str) -> str:
return hmac.new(SECRET, f"{ts}.".encode() + body, hashlib.sha256).hexdigest()
def verify(body: bytes, ts: str, sig: str) -> bool:
if not ts.isdigit() or abs(time.time() - int(ts)) > 300:
return False # stale or missing timestamp
return hmac.compare_digest(sign(body, ts), sig)
Três detalhes são importantes:
- Use os bytes do corpo bruto. Se uma estrutura analisar e serializar novamente o JSON primeiro, o espaçamento ou a ordem das chaves poderão mudar e a assinatura não corresponderá.
- Compare em tempo constante.
hmac.compare_digestleva o mesmo tempo, independentemente do primeiro ou do último caractere ser diferente, o que anula os ataques de tempo. Uma planície==pode parar na primeira incompatibilidade. - Mantenha o segredo fora do código. Armazene-o em variáveis de ambiente ou em um gerenciador de segredos e alterne-o se houver vazamento.
Nossos resultados de teste
Iniciamos o receptor em uma porta local e enviamos seis tipos de solicitação:
1 valid: (200, 'ok')
2 same event again (retry): (200, 'duplicate ignored')
3 tampered body: (401, 'bad signature')
4 wrong secret: (401, 'bad signature')
5 replay 10 min old: (400, 'stale timestamp')
processed events: ['payment.succeeded', 'order.created']
Para o caso adulterado, assinamos um corpo com "amount": 500 e depois alteramos para 5000 em trânsito. A assinatura não corresponde mais, então a solicitação foi rejeitada. Uma assinatura feita com um segredo adivinhado falhou da mesma forma. Apenas dois eventos foram processados no total, embora tenham chegado mais solicitações. Os códigos de status seguem o significado HTTP normal, conforme listado em nossa folha de referências de códigos de status HTTP.
Proteção de repetição
Uma assinatura válida prova que o provedor criou a solicitação, mas não que ela seja recente. Um invasor que capturar uma solicitação genuína poderá reenviá-la mais tarde. Incluir o carimbo de data/hora nos dados assinados e rejeitar qualquer coisa com mais de alguns minutos fecha essa lacuna. Nosso pedido de 10 minutos foi rejeitado antes mesmo de sua assinatura ser verificada. Mantenha os relógios dos servidores sincronizados ou eventos genuínos também poderão ser rejeitados.
Dica: registre o motivo de cada webhook rejeitado, mas nunca registre o segredo ou a assinatura completa. Os logs de rejeição são como você percebe um segredo mal configurado após uma rotação.
Novas tentativas com espera
Os provedores tentam novamente quando seu endpoint falha, atinge o tempo limite ou retorna um status diferente de 2xx. Simulamos um endpoint que falhou duas vezes antes de se recuperar, com um remetente que esperou mais tempo entre cada tentativa:
attempt 1: 500 temporarily down
attempt 2: 500 temporarily down
attempt 3: 200 ok
delivered: True
Nosso remetente dobrou a espera a cada vez (50, 100 e depois 200 milissegundos). Provedores reais usam a mesma ideia durante minutos e horas, muitas vezes por um dia ou mais, depois desistem e podem desabilitar o endpoint. Retorne 4xx apenas para solicitações que você nunca aceitará, como assinaturas incorretas, porque alguns provedores param de tentar novamente em caso de erros do cliente.
Idempotência: processar cada evento uma vez
Novas tentativas significam que você receberá alguns eventos mais de uma vez, por exemplo, quando seu servidor processou um evento, mas a resposta foi perdida. Seu manipulador deve ser idempotente: manipular o mesmo evento duas vezes deve ter o mesmo efeito que tratá-lo uma vez. Armazenamos cada ID de evento e respondemos às repetições com “duplicado ignorado”. Na produção, armazene os IDs em uma tabela de banco de dados com uma restrição exclusiva, para que duas entregas paralelas não possam escapar.
Responda rápido, trabalhe mais tarde
Os provedores esperam apenas alguns segundos pela sua resposta. Se o seu manipulador envia e-mails, chama outras APIs ou executa relatórios, faça esse trabalho após responder: verifique, salve o evento em uma fila ou tabela, retorne 200 e processe-o em um trabalho em segundo plano. Isso evita que as entregas expirem e evita uma tempestade de novas tentativas durante um período lento. Os eventos também podem chegar fora de ordem, portanto verifique o estado atual do objeto em vez de assumir que cada evento é o mais recente.
Como testar webhooks
- Teste unitário do verificador com corpo conhecido, carimbo de data/hora e assinatura esperada, além de casos adulterados e expirados.
- Execute o receptor localmente e envie solicitações assinadas, como fizemos, ou use a CLI ou o painel do provedor para enviar eventos de teste.
- Use uma ferramenta de tunelamento para expor uma porta local quando o provedor precisar acessar seu laptop; feche-o depois.
- Teste duplicatas, eventos fora de ordem e serviços downstream lentos, não apenas o caminho feliz.
Ferramentas como o Postman também podem enviar solicitações de webhook criadas manualmente; consulte nosso guia de testes de API com Postman.
Lista de verificação de segurança do webhook
- Aceite apenas HTTPS.
- Verifique a assinatura HMAC no corpo bruto com uma comparação de tempo constante.
- Rejeite carimbos de data/hora fora de uma janela curta.
- Armazene IDs de eventos e ignore duplicatas.
- Mantenha o segredo na configuração, não no código, e suporte a rotação.
- Responda rapidamente e processe em segundo plano.
- Trate a carga útil como entrada não confiável; busque detalhes críticos da API do provedor em caso de dúvida.
Considerações finais
Webhooks são aparentemente simples, apenas um HTTP POST, mas um receptor confiável precisa de alguns hábitos deliberados. Nossos testes mostraram que cada um deles estava funcionando: as assinaturas pararam de adulterar e enviar remetentes falsos, os carimbos de data e hora interromperam as repetições, os IDs de evento interromperam o processamento duplo e a espera realizou uma entrega durante uma breve interrupção. Crie-os desde a primeira versão e os webhooks se tornarão uma das integrações mais confiáveis que você executa.
Perguntas frequentes
O que é um webhook em termos simples?
Um webhook é uma solicitação HTTP automática que um sistema envia para um URL que você escolhe quando um evento acontece, como o sucesso de um pagamento. Isso evita que você pesquise alterações repetidamente.
Qual é a diferença entre um webhook e uma API?
Com uma API, seu código solicita dados ao provedor. Com um webhook, o provedor envia dados ao seu endpoint quando algo acontece. Muitos serviços oferecem ambos.
Como posso verificar uma assinatura de webhook?
Recalcule um HMAC, geralmente SHA-256, sobre o corpo da solicitação bruta e o carimbo de data/hora com seu segredo compartilhado e, em seguida, compare-o com o cabeçalho usando uma função de tempo constante, como hmac.compare_digest.
Por que recebo o mesmo webhook duas vezes?
Os provedores tentam novamente quando não obtêm uma resposta 2xx a tempo, mesmo que você já tenha processado o evento. Armazene IDs de eventos e ignore duplicatas para que o tratamento permaneça idempotente.
Qual código de status um endpoint de webhook deve retornar?
Retorne um código 2xx rapidamente assim que o evento for verificado e armazenado. Retorne 4xx para solicitações que você nunca aceitará, como assinaturas incorretas, e 5xx quando quiser que o provedor tente novamente.
Continue aprendendo
Precisa de ajuda com testes, WordPress ou SEO?
Ajudamos as equipes a fornecer software melhor e a expandir seus sites. Diga-nos no que você está trabalhando e sugeriremos um próximo passo claro.
Mais guias sobre testes, IA e desenvolvimento moderno
Gostou deste artigo? Escolha um tópico e vá direto para nossos tutoriais mais recentes.
Estratégias de chunking RAG explicadas: fixo, sobreposição, frase, recursivo e títulos, medidos
Estratégias de chunking RAG comparadas em um documento com tiktoken 0.14: tamanho fixo, sobreposição, empacotamento de frases, divisão recursiva e p…
Leia o artigo →Desenvolvimento de softwareExplicação da idempotência da API: chaves de idempotência e novas tentativas seguras, testadas
A idempotência da API explicada com um servidor e cliente Python que executamos: uma resposta perdida causava uma cobrança dupla sem uma chave e uma…
Leia o artigo →DevOpsGit Stash explicado: salvar, aplicar, abrir e não rastrear arquivos, testado
Git stash explicado com comandos que executamos no Git 2.56: push com uma mensagem, arquivos não rastreados, listar e mostrar, aplicar vs pop, mante…
Leia o artigo →Teste de softwareExplicação do teste em pares: como todos os pares reduzem 216 testes para 13, testados
Testes em pares explicados com um gerador que executamos em Python 3.13: um checkout com 216 combinações cobertas por 13 testes, cobertura verificad…
Leia o artigo →Automação de testesDuplas de teste explicadas: Dummy, Stub, Spy, Mock e Fake, com código Python testado
O teste duplo é explicado com um exemplo de Python executado no pytest 9.2: dummy, stub, spy, mock e fake, quando usar cada um, verificações de esta…
Leia o artigo →Bancos de dados e SQLSQL COALESCE explicado: padrões, NULLIF, IFNULL vs ISNULL e traps, testados
SQL COALESCE explicado com consultas que executamos no SQLite 3.50: primeiros valores não nulos, strings vazias, NULL em matemática, NULLIF para div…
Leia o artigo →Bancos de dados e SQLSQL Self Join explicado: funcionário-gerente, comparações de pares e linhas, testado
Auto-junção SQL explicada com consultas que executamos no SQLite 3.50: funcionário e gerente, ganhando mais que o gerente, pares únicos, alterações …
Leia o artigo →Desenvolvimento de softwareExplicação do operador JavaScript Spread: Spread vs Rest, cópias e pegadinhas, testado
O operador de propagação JavaScript explicado com o código que executamos no Nó 24: arrays, objetos, cópias superficiais, parâmetros restantes, o li…
Leia o artigo →Desenvolvimento de softwareMódulo de coleções Python explicado: contador, defaultdict, deque e mais, testado
Coleções Python explicadas com código que executamos em Python 3.13: Counter, defaultdict, deque, nomeadotuple, OrderedDict e ChainMap, além de um t…
Leia o artigo →Inteligência artificialJanela de contexto LLM explicada: tokens, limites e como ajustar mais, medidos
A janela de contexto do LLM explicada com contagens de tokens que medimos usando tiktoken: palavras versus tokens para prosa, código e hindi, orçame…
Leia o artigo →Desenvolvimento de softwareWebhooks explicados: como funcionam e como recebê-los com segurança
Webhooks explicados com um receptor e remetente que executamos em Python: push vs polling, assinaturas HMAC-SHA256, rejeição de solicitações adulter…
Leia o artigo →DevOpsGit Cherry-Pick explicado: copie o commit que você precisa, com segurança e testado
Git cherry-pick explicado com comandos que executamos no Git 2.56: copiar um hotfix para um branch de lançamento, novos hashes e patch-ids, -x, -n, …
Leia o artigo →Automação de testesExplicação do teste instantâneo: como funciona, quando ajuda e quando dói
O teste de instantâneo foi explicado com uma demonstração pytest e xaroposa que executamos: criação de instantâneos, leitura da diferença após uma a…
Leia o artigo →Teste de softwareExplicação do teste de mutação: por que a cobertura de 100% ainda não percebeu nosso bug
Os testes de mutação explicados com uma pequena ferramenta de mutação que construímos e executamos: 14 mutantes, um conjunto de testes com 100% de c…
Leia o artigo →Inteligência artificialExplicação da injeção imediata: como os aplicativos de IA são enganados e como defendê-los
Injeção imediata explicada para construtores: ataques diretos e indiretos, por que os filtros de palavras-chave falham (nosso teste bloqueou 1 de 4)…
Leia o artigo →DevOpsRegistros DNS explicados: A, AAAA, CNAME, MX, TXT e TTL com pesquisas reais
Registros DNS explicados com pesquisas que executamos: como funciona a resolução, A e AAAA, regras CNAME, MX e MX nulo, TXT para SPF e verificação, …
Leia o artigo →DevOpsSinalizadores de recursos explicados: lançamentos seguros, lançamentos graduais e higiene de sinalizadores
Sinalizadores de recursos explicados com uma simulação de implementação que executamos: tipos de sinalizadores, implementações percentuais com hashi…
Leia o artigo →Automação de testesGeração de dados de teste com Python Faker: dados realistas, repetíveis e seguros
Teste a geração de dados com Python Faker, execute e meça: propagação de dados repetíveis, localidades, valores exclusivos, registros em formato de …
Leia o artigo →Teste de softwareExplicação do teste Shift-Left: Encontre bugs mais cedo, sem atrasar a equipe
O teste shift-left explicou: o que significa, por que os defeitos iniciais são mais baratos, práticas desde revisões de requisitos até verificações …
Leia o artigo →Bancos de dados e SQLFunções de string SQL explicadas: TRIM, SUBSTR, REPLACE, CONCAT e limpeza de dados
Funções de string SQL explicadas com consultas que executamos: concatenação e NULL, TRIM, UPPER e LOWER, SUBSTR e INSTR, REPLACE, preenchimento, com…
Leia o artigo →Bancos de dados e SQLExplicação dos gatilhos SQL: gatilhos ANTES e DEPOIS, registros de auditoria e armadilhas
Gatilhos SQL explicados com gatilhos que executamos: ANTES vs DEPOIS, ANTIGO e NOVO, logs de auditoria, validação, atualizações de estoque, condiçõe…
Leia o artigo →Desenvolvimento de softwareMódulo JSON Python explicado: dumps, carregamentos, tipos personalizados e erros comuns
O módulo Python JSON explicado com o código que executamos: dumps e carregamentos, arquivos, conversões de tipo, datas e decimais, codificadores per…
Leia o artigo →Desenvolvimento de softwareMódulos ES vs CommonJS: como funcionam as importações de JavaScript em Node.js, testado
Módulos ES vs CommonJS explicados com código que executamos em Node.js: sintaxe de importação e exportação, require, vinculações ativas, cache, espe…
Leia o artigo →Desenvolvimento de softwarePython Regex explicado: padrões, grupos, antecipações e armadilhas, testados
Regex Python explicado com padrões que executamos: pesquisa vs correspondência, findall, grupos e grupos nomeados, ganancioso vs preguiçoso, sub, lo…
Leia o artigo →Inteligência artificialExplicação da saída estruturada do LLM: obtendo JSON confiável de modelos de IA
Saída estruturada do LLM explicada com validação que executamos no Pydantic: modo JSON e esquemas, decodificação restrita, formas de quebra de saída…
Leia o artigo →DevOpsChaves SSH explicadas: como funcionam, ssh-keygen, Ed25519 e hábitos seguros
Chaves SSH explicadas com chaves que geramos: chaves públicas versus privadas, ssh-keygen, Ed25519 versus RSA, impressões digitais, senhas, agente s…
Leia o artigo →DevOpsCache HTTP explicado: controle de cache, ETag e respostas 304, com um teste ao vivo
Cache HTTP explicado com um pequeno servidor que executamos: diretivas Cache-Control, idade máxima, sem cache vs sem armazenamento, revalidação de E…
Leia o artigo →Automação de testesTeste de contrato de API explicado: detecte alterações importantes antes de serem enviadas
O teste de contrato de API foi explicado com uma verificação de esquema que executamos: o que é um contrato, contratos orientados ao consumidor, Pac…
Leia o artigo →Teste de softwareTestes baseados em riscos explicados: avalie os riscos, construa uma matriz e teste o que é importante
Testes baseados em riscos explicados passo a passo: identificação de riscos, pontuação de probabilidade e impacto, construção de uma matriz de risco…
Leia o artigo →Bancos de dados e SQLRestrições SQL explicadas: NOT NULL, UNIQUE, CHECK e FOREIGN KEY, testadas
Restrições SQL explicadas com testes que executamos: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY e FOREIGN KEY, as lacunas NULL, configuração de chave…
Leia o artigo →Bancos de dados e SQLFunções de data SQL explicadas: adicionando, comparando e agrupando datas sem bugs
Funções de data SQL explicadas com consultas que executamos: adição de intervalos, surpresas de final de mês, diferenças de data, armadilha BETWEEN,…
Leia o artigo →Desenvolvimento de softwarePython assíncio explicado: assíncrono, espera, coleta e TaskGroup com Real Timings
Python asyncio explicado com código que cronometramos: corrotinas, espera, coleta, TaskGroup, tratamento de erros, tempos limite, limitação de simul…
Leia o artigo →Desenvolvimento de softwareDebounce vs Throttle em JavaScript: como funcionam, quando usar cada um, testado
Debounce vs. acelerador em JavaScript explicado com tempos que medimos em Node.js: como cada um funciona, implementações simples, chamadas iniciais …
Leia o artigo →Desenvolvimento de softwareGerenciadores de contexto Python explicados: a instrução with, contextlib e usos reais
Os gerenciadores de contexto Python explicados com o código que executamos: como funciona, __enter__ e __exit__, contextlib.contextmanager, supressã…
Leia o artigo →Inteligência artificialTemperatura LLM e Top-p explicados: como os modelos de IA escolhem sua próxima palavra
Temperatura LLM e top-p explicados com uma simulação que executamos: como as probabilidades são remodeladas, o que top-p mantém, configurações recom…
Leia o artigo →DevOpsYAML explicado: sintaxe, o problema da Noruega e outras armadilhas que testamos
YAML explicado com um teste de analisador: sintaxe básica, listas e mapas, o problema da Noruega, versões que se transformam em carros flutuantes, c…
Leia o artigo →DevOpsCron Jobs explicado: sintaxe, programações reais e os erros que os quebram
Cron jobs explicados com cronogramas que verificamos: os cinco campos, operadores, exemplos reais, a armadilha do dia do mês OU do dia da semana, pr…
Leia o artigo →Inteligência artificialExplicação das alucinações de IA: por que os modelos de linguagem inventam as coisas e como reduzi-las
Explicação das alucinações de IA: o que são, por que os modelos de linguagem as produzem, tipos comuns, como reduzi-las com aterramento e instruções…
Leia o artigo →DevOpsVariáveis de ambiente explicadas: arquivos .env, segredos e configuração bem feitos
Variáveis de ambiente explicadas com exemplos de Python que executamos: leitura e configuração, por que cada valor é uma string, arquivos .env, hera…
Leia o artigo →Desenvolvimento de softwareExplicação da limitação de taxa de API: algoritmos, cabeçalhos e tratamento de erros 429
Limitação de taxa de API explicada com uma simulação que executamos: token bucket, janela fixa, janela deslizante, 429 respostas, cabeçalhos de limi…
Leia o artigo →Automação de testesZombando em Python: unittest.mock, patch e os erros que fazem os testes mentirem
Zombaria em Python com unittest.mock, testado: Mock e return_value, side_effect, patch onde um nome é usado, especificação e autospec, zombaria de d…
Leia o artigo →Teste de softwareCobertura de código explicada: cobertura de linha versus filial e o que 100% realmente significa
Cobertura de código explicada com uma execução cobertura.py real: cobertura de linha, ramal e condição, leitura de um relatório, por que 100% de cob…
Leia o artigo →Bancos de dados e SQLDELETE vs TRUNCATE vs DROP em SQL: diferenças, reversão e quando usar cada um
DELETE vs TRUNCATE vs DROP explicado com SQL testado: o que cada um remove, rollback, aciona, redefinição de identidade, velocidade e como PostgreSQ…
Leia o artigo →Bancos de dados e SQLExibições SQL explicadas: crie, use e evite as armadilhas, com exemplos
Visualizações SQL explicadas com consultas que executamos: criação de uma visualização, resultados ao vivo, ocultação de colunas, desempenho, visual…
Leia o artigo →Desenvolvimento de softwareInterface TypeScript vs tipo: diferenças reais, testadas com o compilador
Interface TypeScript versus tipo, verificada com o compilador real: o que ambos podem fazer, o que apenas um pode fazer, mesclagem de declarações, e…
Leia o artigo →Desenvolvimento de softwarePython *args e **kwargs explicados: funções flexíveis com exemplos claros
Python *args e **kwargs explicados com o código que executamos: empacotamento e descompactação, ordem dos parâmetros, argumentos somente de palavras…
Leia o artigo →Desenvolvimento de softwareFunções Python Lambda: sintaxe, usos reais e quando não usá-los
Funções lambda do Python explicadas com o código que executamos: sintaxe, classificação com chave, mapa e filtro, fechamentos, armadilha de ligação …
Leia o artigo →Inteligência artificialO que são agentes de IA? Como eles funcionam, com um loop de agente simples que você pode executar
O que são agentes de IA? Um guia simples para o loop do agente, ferramentas, memória e proteções, com um pequeno loop Python que executamos, riscos …
Leia o artigo →DevOpsMonitoramento versus observabilidade: a verdadeira diferença, com logs, métricas e rastreamentos
Explicação do monitoramento versus observabilidade: falhas conhecidas e desconhecidas, logs, métricas e rastreamentos, um passo a passo do incidente…
Leia o artigo →DevOpsDocker Volumes vs Bind Mounts: persista os dados do contêiner da maneira certa
Volumes Docker versus montagens de ligação explicadas: por que os dados do contêiner desaparecem, volumes nomeados, montagens de ligação, tmpfs, exe…
Leia o artigo →Automação de testesTDD vs BDD: principais diferenças, um recurso criado de ambas as maneiras e quando usar cada um
TDD vs BDD explicado com um recurso de desconto construído em ambos os sentidos: refatoração vermelho-verde com o código que executamos, cenários da…
Leia o artigo →Teste de softwareTeste de aceitação do usuário (UAT): processo, lista de verificação e exemplos reais
Explicação do teste de aceitação do usuário: quem o executa, como ele difere do controle de qualidade, um processo de sete etapas, um modelo de caso…
Leia o artigo →Bancos de dados e SQLValores SQL NULL explicados: IS NULL, COALESCE, NULLIF e as armadilhas a serem evitadas
Valores SQL NULL explicados com consultas que executamos: lógica de três valores, IS NULL, COALESCE, NULLIF, como agregações, junções e classificaçã…
Leia o artigo →Bancos de dados e SQLInstrução SQL CASE WHEN: sintaxe, exemplos reais e erros comuns
SQL CASE WHEN explicado com consultas que executamos: formulários simples e pesquisados, ordem de condição, pivôs com SUM, truques COUNT, classifica…
Leia o artigo →Desenvolvimento de softwareO que é JWT? JSON Web Tokens explicados com um exemplo prático
O que é JWT? JSON Web Tokens explicados: as três partes, um token construído e adulterado no código que executamos, JWT vs sessões, armazenamento, t…
Leia o artigo →Desenvolvimento de softwareLoop de eventos JavaScript explicado: pilha de chamadas, microtarefas e temporizadores com exemplos
O loop de eventos JavaScript explicado com o código que executamos: pilha de chamadas, filas de tarefas e microtarefas, por que setTimeout 0 não é i…
Leia o artigo →Desenvolvimento de softwareGeradores Python e rendimento explicado: economize memória com exemplos reais
Geradores Python e rendimento explicados com o código que executamos: como eles pausam e reiniciam, medem economia de memória, pipelines, sequências…
Leia o artigo →Inteligência artificialO que são incorporações? Similaridade de vetores e cossenos explicada de forma simples
O que são incorporações? Um guia em linguagem simples para vetores, similaridade de cossenos e pesquisa semântica, com um pequeno exemplo que execut…
Leia o artigo →DevOpsImplantação azul-verde vs canário: diferenças, compensações e como escolher
Explicação da implantação azul-verde versus canário: como cada um funciona, custo, risco e reversão, agrupamento estável de usuários que testamos, m…
Leia o artigo →Automação de testesTestes instáveis: o que os causa e como corrigi-los para sempre
Testes instáveis explicados com demonstrações que executamos: as principais causas, como confirmar e diagnosticar uma, soluções adequadas para tempo…
Leia o artigo →Teste de softwareTeste de carga versus teste de estresse: diferenças, métricas e exemplos k6
Teste de carga versus teste de estresse explicado: o que cada um prova, testes de pico e absorção, as métricas que importam, por que as médias engan…
Leia o artigo →Teste de softwareCaso de teste versus cenário de teste: principais diferenças, exemplos e quando usar cada um
Caso de teste vs cenário de teste explicado: definições claras, uma tabela lado a lado, um recurso de redefinição de senha retirado de cenários para…
Leia o artigo →Bancos de dados e SQLOtimização de consultas SQL: leia planos de execução e corrija consultas lentas, com intervalos
Otimização de consulta SQL testada em um milhão de linhas: leia planos de execução, adicione os índices corretos, corrija filtros não sargáveis, use…
Leia o artigo →Bancos de dados e SQLSQL UNION vs UNION ALL: diferenças, exemplos e desempenho testado
SQL UNION vs UNION ALL explicado com consultas que executamos: duplicatas, as regras que ambos seguem, um bug de dados real, desempenho medido, INTE…
Leia o artigo →Desenvolvimento de softwareTutorial da API JavaScript Fetch: GET, POST, tratamento de erros e tempos limite
Um tutorial da API JavaScript Fetch testado em um servidor local: GET e POST, por que 404 não lança, um auxiliar reutilizável, strings de consulta, …
Leia o artigo →Desenvolvimento de softwareManipulação de arquivos Python: leitura, gravação, CSV, JSON e pathlib com exemplos
Manipulação de arquivos Python explicada com código que executamos: modos abertos, com, leitura de arquivos grandes, CSV, JSON, pathlib, arquivos bi…
Leia o artigo →Desenvolvimento de softwareClasses e objetos Python: tutorial OOP com exemplos reais
Classes e objetos Python explicados com código que executamos: __init__, métodos, atributos de classe vs instância, herança, propriedades, métodos d…
Leia o artigo →Inteligência artificialO que é um modelo de linguagem grande? Como funcionam os LLMs, explicado sem exageros
O que é um modelo de linguagem grande? LLMs explicados em linguagem simples: tokens, incorporações, atenção, treinamento, temperatura e janelas de c…
Leia o artigo →DevOpsComandos Linux para iniciantes: o guia essencial do terminal com exemplos
Comandos Linux para iniciantes, agrupados por tarefa: navegação, arquivos, visualização de logs, grep, pipes, permissões, processos e arquivos, com …
Leia o artigo →Automação de testesSelenium vs Playwright: principais diferenças, código comparado e qual escolher
Selenium vs Playwright comparado: arquitetura, espera, suporte a navegador e linguagem, depuração, o mesmo teste em ambas as ferramentas, conselhos …
Leia o artigo →Teste de softwareParticionamento de equivalência: técnica de design de teste explicada com exemplos resolvidos
Explicação do particionamento de equivalência: como encontrar partições válidas e inválidas, exemplos resolvidos para idades, senhas e cupons, teste…
Leia o artigo →Teste de softwareGravidade vs Prioridade em Testes de Software: Diferenças, Matriz e Exemplos Reais
Explicação da gravidade versus prioridade em testes de software: definições claras, uma matriz de quatro vias com exemplos, escalas de nível, quem d…
Leia o artigo →Bancos de dados e SQLTutorial de subconsultas SQL: tipos, subconsultas correlacionadas e EXISTS com exemplos
Um tutorial de subconsultas SQL com consultas que executamos: subconsultas escalares, IN, FROM e SELECT, subconsultas correlacionadas, EXISTS, a arm…
Leia o artigo →Bancos de dados e SQLTransações SQL e ACID explicados: COMMIT, ROLLBACK e níveis de isolamento
Transações SQL e ACID explicadas com uma transferência bancária que executamos: COMMIT, ROLLBACK, savepoints, locks, níveis de isolamento, leituras …
Leia o artigo →Desenvolvimento de softwareFolha de dicas dos comandos do Git: os comandos que você realmente usa, com exemplos
Uma folha de dicas de comandos Git agrupada por tarefa: configuração, preparação, ramificações, controles remotos, stash, histórico e desfazer erros…
Leia o artigo →Desenvolvimento de softwareExplicação das promessas de JavaScript: então, catch, Promise.all e erros comuns
Promessas JavaScript explicadas com o código que executamos: estados, cadeias then e catch, tratamento de erros, Promise.all, allSettled, race e any…
Leia o artigo →Desenvolvimento de softwareTutorial do dicionário Python: métodos, exemplos e padrões comuns
Um tutorial de dicionário Python com código que executamos: criar, ler e atualizar dictos, métodos-chave, mesclagem, compreensão, padrões de contage…
Leia o artigo →Inteligência artificialO que é RAG? Geração aumentada de recuperação explicada com um exemplo prático
O que é RAG? Geração aumentada de recuperação explicada passo a passo: indexação, chunking, embeddings, recuperação, um pequeno exemplo funcional de…
Leia o artigo →DevOpsTutorial Terraform para iniciantes: infraestrutura como código do primeiro arquivo aos módulos
Um tutorial do Terraform para iniciantes: comece sem conta na nuvem, aprenda como iniciar, planejar e aplicar, depois variáveis, saídas, estado, mód…
Leia o artigo →DevOpsDocker vs Kubernetes: principais diferenças, como eles funcionam juntos e o que você precisa
Docker vs Kubernetes explicado: o que cada um faz, o mesmo aplicativo rodando com ambos, Docker Compose e Swarm comparados, a mudança do dockershim …
Leia o artigo →Automação de testesTutorial Pytest para iniciantes: luminárias, parametrização e exemplos reais
Um tutorial pytest para iniciantes com testes que executamos no pytest 9.2: asserções, fixtures, parametrizar, conftest, marcadores, tmp_path, monke…
Leia o artigo →Teste de softwareCiclo de vida de teste de software (STLC): 6 fases, critérios de entrada e saída, exemplo
O ciclo de vida de teste de software explicou: seis fases do STLC com critérios de entrada e saída, resultados, um exemplo de recurso de login funci…
Leia o artigo →Desenvolvimento de softwareGit merge vs rebase: diferenças, exemplos e quando usar cada um
Git merge vs rebase explicado com saída real do log, uma tabela comparativa, a regra de ouro do rebase e um fluxo de trabalho seguro para equipes.
Leia o artigo →Desenvolvimento de softwareList comprehension em Python: sintaxe, exemplos e quando evitar
List comprehension em Python explicada: sintaxe, filtros, if-else, laços aninhados, tempos medidos e quando um laço for comum é a melhor escolha.
Leia o artigo →Bancos de dados e SQLSQL JOIN explicado com exemplos (Inner, Left, Right, Full)
Entenda os joins SQL passo a passo com tabelas e consultas de exemplo: INNER, LEFT, RIGHT, FULL, CROSS e SELF, além de erros comuns e dicas de desem…
Leia o artigo →