DEV Community: Matheus Patricio

WebHook x WebSocket : O que são?

Matheus Patricio — Tue, 30 Dec 2025 20:09:20 +0000

A importância das integrações

Como desenvolvedor, nos deparamos com diversos tipo de integrações e maneiras de desenvolver uma solução. Um grande exemplo disso, seria uma grande dúvida: Se eu tenho um App que utiliza PSP's (Payment Service Provider), como posso saber que meu pagamento foi Aprovado, Recusado ou deu algum tipo de erro?

Podemos pensar primeiramente em 3 tipos de soluções: Short pooling, Long Pooling e Webhooks.

Short Pooling
Nesse tipo de integração, o servidor fica enviando requests e recebendo responses em um tempo intervalado pequeno. Basicamento, o servidor fica falando: "Meu pagamento foi processado?", "Meu pagamento foi processado?", "Meu pagamento foi processado?"

E então o PSP responde: "Ainda não", "Ainda não", "Ainda não", "Opa, aqui estão os seus dados de pagamento!". Assim então, o PSP envia o objeto dos dados do pagamento.

Long Pooling
Aqui, a lógica ainda é parecida. A conexão com o servidor e PSP é mantida, até o servidor receber sua response ou receber um timeout. Caso timeout, o servidor inicia outra conexão e fica repetindo esse ciclo até receber os dados corretamente.

WebHook: Aqui a mágica acontece

Um WebHook nada mais que consiste em um endpoint onde o PSP deverá enviar os dados do serviço que você esta utilizando. Um nome mais lógico, segundo Augusto Galego, seria API inversa e você vai entender o porquê disso. Em vez de precisarmos de um API polling, fazendo requests sem parar para o servidor do PSP, podemos simplesmente falar para o PSP o seguinte: "Olha, tenho esse endpoint aqui. Me avise por meio dele quando as minhas requests estiverem prontas". Dessa forma, é salvo poder de processamento tanto do servidor, quanto do PSP ao deixar de usar API polling.

Exemplo prático: Imagine que você tem um Saas que tem pagamento integrado com por exemplo AbacatePay. Toda vez que você fizer um pagamento, seu servidor irá gerar uma request para AbacatePay, pedindo, por exemplo, um código de pagamento via PIX. Ao receber esse código e efetuar o pagamento, como podemos saber que esse pagamento foi processado corretamente, sem precisar enviar inúmeras requests perguntando para AbacatePay? A resposta é simples: com o Webhook.

Lembra que falamos: "Abacate, quando meu pagamento for processado, me avise por meio dessa url de webhook."? É exatamente aqui que a Abacate vai falar: "Opa, ok. Aqui estão seus dados do pagamento". E então os dados são enviados para aquele endpoint no seu servidor.

Mas por quê API Inversa?
Por quê em vez de precisarmos enviar diversos requests para o PSP, o próprio PSP irá fazer um POST no nosso endpoint com os dados do pagamento. Por isso esse nome lógico.

Websocket: Conexão em tempo real

O WebSocket consiste em um protocolo de comunicação em tempo real que permite a troca de mensagens entre cliente e servidor de forma bi-direcional, através de uma conexão persistente.

Diferente do modelo tradicional HTTP (request/response), no WebSocket a conexão é estabelecida uma única vez e permanece aberta, permitindo que ambas as partes enviem dados a qualquer momento, sem a necessidade de novas requisições. Após um handshake inicial via HTTP, a comunicação passa a ocorrer por meio de frames WebSocket, o que reduz significativamente o overhead e resulta em baixa latência.

Esse modelo é amplamente utilizado em cenários que exigem atualizações em tempo real, como chats, dashboards em tempo real, jogos online, notificações e monitoramento de sistemas.

Exemplo prático

Imagine que você possui um SaaS com um painel administrativo em tempo real, onde o usuário acompanha o status de pagamentos realizados na plataforma.

Quando um pagamento é iniciado, seu backend se comunica com o PSP (via API ou Webhook). Assim que o pagamento é aprovado, recusado ou apresenta erro, o backend recebe essa informação.
Agora, como informar isso instantaneamente para o usuário que está com o dashboard aberto no navegador?

É aqui que o WebSocket entra.

Ao acessar o painel, o frontend do usuário estabelece uma conexão WebSocket com o seu servidor. Essa conexão permanece ativa enquanto o usuário estiver logado. Quando o backend recebe a confirmação do pagamento (por exemplo, via Webhook do PSP), ele envia imediatamente uma mensagem pelo WebSocket para o cliente conectado, informando:

"Pagamento aprovado",
"Pagamento recusado",
ou "Erro no processamento do pagamento".

Dessa forma, o usuário vê a atualização em tempo real, sem precisar atualizar a página ou fazer novas requisições HTTP.

Amazon Elastic Compute Cloud (Amazon EC2)

Matheus Patricio — Wed, 28 May 2025 02:23:14 +0000

O que é o Amazon EC2?

Basicamente, define-se o EC2 como a máquina virtual como um serviço. a AWS fornece a capacidade computacional e redimensionável como instancias do Amazon EC2.

A AWS oferece a plataforma de computação com mais de 750 instâncias e opções de processadores, armazenamentos, redes, sistemas operacionais e modelos de compras mais recentes para ajudar você a atender melhor às necessidades da sua workload.

Como são os recursos on-premises tradicionais?

São compostos por componentes de hardware complexos, onde se necessitava gastar com hardware antecipadamente, aguardar qeu os servidores sejam entregues a sua empresa, preparar uma sala especifica para comportar e manter os servidores e fazer todas as configurações necessárias como Firewall, anti-virus, Sistema operacional.

Vantagens de utilizar uma instância do EC2:

Capacidade de provisionar e iniciar uma instacia EC2 em minutos
Capacidade de interromper o trabalho quando terminar o trabalho desejado
Economia de custos, pagando apenas oque foi utilizado no tempo/uso de computação.

Tipos de instancias do Amazon EC2

Os tipos de instâncias do Amazon EC2 são otimizadas para tarefas diferentes. Dessa forma, voce deve considerar as necessidades específicas de suas cargas de trabalho e aplicações.

Instancias de uso geral: Equilibram os recusos de computação, memória e rede. Pode ser usada em diversas cargas de trabalho como servidores de aplicações, servidores de jogos, backend de aplicações, bancos de dados. Ideal para aplicações/serviços que não precisam otimização em nenhuma área de recurso único.
Instâncias otimizadas para computação: Ideais para computação que usam processadores de alto desempenho. Sendo possivel usar em cargas de trabalho pesado de processamento em lote, com o processamento de muitas transações em um unico grupo.
Instâncias otimizadas para memória: Tem desempenho rápido para cargas qeu processam grandes conjuntos de dados na memória. Esse cenário pode ser um banco de dados de alto desempenho ou carga de trabalho que envolva a execução de processamento em tempo real de uma grande quantidade de dados não estruturados.
Instâncias otimizadas para Computação acelerada: Usam aceleradores de hardware, ou coprocessadores, para executar algumas funções de maneira mais eficiente do que é possivel em um software executado por CPUs. Um grande exemplo de uso são calculos complexos, processamento de gráficos, correspondencia de padrões de dados. Sendo ideal para aplicativos gráficos e streaming de jogos e apps.
Instâncias otimizadas para armazenamento: São projetadas para cargas de trabalho que exigem alto acesso sequencial de leitura e gravação e grandes conjuntos de dados no armazenamento local. Grande exemplos são sistemas de arquivos distribuídos, aplicações de data warehouse e sistemas de processamento de transação on-line (OLTP) de alta frequência. Ideal para aplicativos com altos requisitos de IOPS.

Definição de precos do Amazon EC2

Com o Amazon EC2, voce paga apenas pelo tempo de computação que usar. A Amazon oferece diversas opções de preço para diferentes de casos de uso.

Sob demanda: São ideias para cargas de trabalho irregulares, onde são executadas continuamente até que sejam interrompidas, e voce paga apenas pelo tempo que usou. Normalmente usadas para desenvolvimento e teste de aplicações.
Instâncias reservadas: São um desconto no valor do uso de instâncias sob demanda. Possuem vigencia de 1 ou 3 anos, sendo que a maior economia de custos se dá com a opção de 3 anos. Há dois tipos de instância reservada: A padrão que é adequada se o cliente souber o tipo e o tamanho da instancia e em qual regiao da AWS planeja executa-las. E as conversíveis, que é adequada quando voce precisa executar as instancias em diferentes zonas de disponibilidade ou diferentes tipos de instancia.
Saving Plans da instância do EC2: Assume compromisso de gasto por hora com uma familia de instâncias e uma região por um período de um ou três anos. Gera uma economia de até 72% comparado com instâncias sob demanda. Nesse caso, não é necessário especificar antecipadamente qual tipo e tamnho da istância do EC2, SO, Tenacy. Além disso não é necessário se comprometer com um determinado número de instâncias do EC2.
Instâncias spot: São idais para cargas de trabalho com horários de inicio e término flexiveis ou que toleram interrupções. Usam a capacidade de computação não utilizada do Amazon EC2 e tem até 90% de desconto em relação a sob demanda. As instâncias sport poderão ser interrompidas se não houver mais capacidade disponível ou se a demanda por essas instâncias aumentar.
Hosts dedicados: São servidores fisicos com capacidade de instancia do Amazon EC2 taotalmente dedicada ao uso do cliente. Podendo comprar as licenças de uso de software por soquete, nucleo ou por VM. Além disso, adquirir hosts dedicados sob demanda e reservas de hosts dedicados. São os mais caros entre todas opções.

📚 Conclusão

O Amazon EC2 oferece uma base robusta e flexível para executar aplicações na nuvem, permitindo que empresas dimensionem seus recursos de forma rápida, segura e econômica. Com opções personalizáveis de instâncias, modelos de cobrança sob demanda e ampla integração com outros serviços da AWS, o EC2 capacita organizações a atenderem desde pequenas aplicações até cargas de trabalho corporativas complexas. Ao entender seu funcionamento e possibilidades, as empresas podem usar o EC2 como um pilar essencial para inovação, alta disponibilidade e crescimento sustentável na nuvem.

🎓Referências

AWS

🧑‍💻 Autor

Matheus Patricio

Onde me achar?

Linkedin
Github
Portfolio

🙏 Agradecimentos

Se você ficou até aqui, agradeço de coração.
Até mais!

☁️ Conceitos básicos de Computação em nuvem ☁️

Matheus Patricio — Sat, 24 May 2025 13:34:35 +0000

☁️ O que é Cloud Computing?

Cloud computing é o conceito de fornecimento de recurso de TI (Tecnologia da informação) sob demanda com pagamento conforme o uso. Os recursos abragem tecnologias como: servidores, armazenamento, banco de dados, redes, softwares.

Provedores como Amazon Web Services(AWS), Google Cloud Platform(GCP), Microsoft Azure, Oracle Cloud são responsáveis por fornecer e gerenciar tais recursos para seus clientes.

🚀 Mas por que usar Cloud Computing na minha empresa/serviço?

Redução de custos: O primeiro grande motivo que a maioria das empresas toma a decisão de usar Cloud Computing é Redução de custos, isso por não necessitar de grandes investimentos inicias em hardware e tempo de implementação.
Elasticidade: Outro grande motivo é a capacidade de aumentar ou diminuir recursos de acordo com as necessidades. A provedora de cloud faz o ajuste automático dos recursos para lidar com variações de demanda, seja ela de tráfego, RAM, processamento ou armazenamento, garantindo desempenho e economia sem intervenção manual.
Escalabilidade : É a capacidade de aumentar ou diminuir recursos de acordo com as necessidades. A provedora disponibiliza maiores e melhores recursos para atender melhor o seu serviço/empresa. A grande diferença de escalabilidade e elasticidade é que na elasticidade os recursos são gerenciados conforme a demanda de forma dinâmica, já a escalabilidade é o aumento de recursos de forma planejada, pensando principalmente no futuro.
Disponibilidade global: Significa que os serviços estão disponíveis e acessíveis o tempo todo e de, basicamente, qualquer lugar do mundo.
Agilidade e velocidade: A implementação de novos servidores e serviços das provedoras de cloud estão no espaço tempo de alguns cliques, sendo assim a implementação ou mudanças nos servidores e serviços, extremamente rápida.

🌎 Modelos de serviços em cloud computing

Iaas (Infraestructure as a service) : Nesse modelo a provedora fornece serviços como servidores, bancos de dados, redes, armazenamento. O cliente gerencia o sistema operacional, aplicativos e dados, enquanto o provedor cuida da infraestrutura física. Exemplos são: Amazon EC2, Microsoft Azure VMs
Paas (Platform as a service) : Nesse modelo a provedora fornece um ambiente completo para desenvolvimento, testes e implantação de aplicações. O provedor gerencia infraestrutura, sistema operacional e plataformas, deixando o usuário focar apenas no código e na lógica da aplicação. Exemplos são: Google App Engine, Microsoft Azure App Services.
Saas (Software as a service) : Nesse modelo é composto por aplicações prontas para uso, acessadas pela internet via navegador, sem necessidade de instalação ou manutenção local. O provedor cuida de tudo: infraestrutura, aplicação, atualizações e segurança. Exemplos são: Google Workspace (Gmail, Docs), Microsoft 365, Salesforce

🌌 Modelos de Implementação em Cloud Computing

Nuvem Pública (Public Cloud)
- Infraestrutura gerenciada por um provedor externo e compartilhada com outros clientes.
- Mais escalável e com menor custo inicial.
- Exemplo: AWS, Azure, Google Cloud.
Nuvem Privada (Private Cloud)
- Infraestrutura dedicada exclusivamente a uma organização.
- Maior controle, segurança e personalização.
- Pode ser local (on-premise) ou hospedada por terceiros.
Nuvem Híbrida (Hybrid Cloud)
- Combinação de nuvem pública e privada.
- Permite mover dados e aplicações entre ambientes conforme a necessidade.
- Flexível e ideal para cargas sensíveis e variáveis.
Multinuvem (Multicloud)
- Uso de múltiplos provedores de nuvem pública ao mesmo tempo.
- Aumenta a disponibilidade e evita dependência de um único fornecedor.
- Exemplo: usar AWS para computação e Google Cloud para Big Data.

📚 Conclusão

A computação em nuvem oferece uma ampla gama de benefícios e vantagens, desde redução de custos e aumento da escalabilidade até maior agilidade e disponibilidade global. Ao compreender os diferentes modelos e conceitos-chave, as empresas podem aproveitar ao máximo o poder da nuvem para impulsionar a inovação e o crescimento.

🎓Referências

AWS
GCP

🧑‍💻 Autor

Matheus Patricio

Onde me achar?

Linkedin
Github
Portfolio

🙏 Agradecimentos

Se você ficou até aqui, agradeço de coração.
Até mais!

Validações com biblioteca Yup

Matheus Patricio — Fri, 18 Apr 2025 17:55:52 +0000

Quando lidamos com formulários, inserções de dados em algum serviço como enviar um POST para um banco de dados, salvando os dados inseridos no banco, jamais podemos esquecer de validar os dados inseridos.

Dessa forma não poluímos nosso serviço ou banco de dados com dados inválidos, vazios ou sem sentido a respeito das regras de negócios da nossa aplicação.

Para isso podemos validar cada campo com os parametros necessários. Por exemplo, o campo "Nome" não pode ter menos de 3 caracteres.

if (nome.length < 3) {
  console.log("Erro: o nome deve ter pelo menos 3 caracteres.");
}

Agora imagine que você tem os campos: nome, idade, peso, altura.
Ainda assim é possivel validar, ainda que dê mais trabalho, aplicando as regras de negócio, imagine que um cadastro NÃO pode ser efetuado sem nome e idade, em hipótese alguma.

  //validação nome
  if (!nome) {
    console.log("Erro: o nome é obrigatório.");
    return false;
  } else if (nome.length < 3) {
    console.log("Erro: o nome deve ter pelo menos 3 caracteres.");
    return false;
  }
  //validação idade
  if (idade === undefined || idade === null || idade === "") {
    console.log("Erro: a idade é obrigatória.");
    return false;
  }
  if (idade < 0 || idade > 120) {
    console.log("Erro: a idade deve estar entre 0 e 120.");
    return false;
  }

🛠️ O problema

Apenas 2 campos geraram 17 linhas de código, agora pense que você tem 10, 20 campos a serem validados com parametros diferentes nesse mesmo campo, quantas linhas seriam necessárias para validar TODOS os campos corretamente? o quanto do seu TEMPO seria necessário para resolver esse problema? outras pessoas seriam capazes de mexer nesse bloco de código caso você não pudesse? e para dar manutenção nesse tipo validação, ficaria legível?

A resposta é NÃO, o código se tornaria extenso, de difícil leitura e manutenção, transformando uma tarefa simples em algo trabalhoso e sujeito a erros. Além disso, um desenvolvedor deve solucionar um problema e não criar outros 4!

✅ A solução

Para isso, podemos utilizar a biblioteca Yup para nos ajudar. A Yup é uma biblioteca javascript poderosa e intuitiva quando falamos em validação de dados e formulários, ela ajuda a garantir que os dados estejam no formato correto, com tipos certos, campos obrigatórios, e regras personalizadas.

📦 Instalação

npm: npm install yup
yarn: yarn add yup

Caso exemplo

Temos que fazer um POST dentro de um banco de dados com uma API em Typescript, sabendo disso, podemos criar uma Interface para modelar como os dados devem ser enviados e utilizar a Yup para validar.

import { Router } from "Express" // Router
import * as yup from 'yup'; //importando a biblioteca após instalar

// interface 
interface ICarro {
   modelo: string,
   ano: number,
   cor: string,
   fabricante: string,
   placa: string
   modificacao?: string[]
}

// schema da yup para validação

const bodyValidation: yup.ObjectSchema<ICarro> = yup.object({
  modelo: yup.string().required("Digite o modelo do carro"),

  ano: yup.number().required().min(1886, "ano inválido"),
       // o primeiro carro foi em 1886

  cor : yup.string().required("Digite a cor do carro"),

  fabricante: yup.string().required("Digite a fabricante do carro"),

  placa: yup.string()
            .required('A placa é obrigatória')
            .matches(/^[A-Z]{3}-\d{4}$/, 'Placa no formato inválido (ex: ABC-1234)'),
         //regex para o padrão de placa brasileira

  modificacao: yup.array().of(yup.string()).optional()
        //modificacao é um array de string opcional

})

// Metodo que faz o POST, o body da requisição recebe a interface

export const post = async (req: Request<{}, {}, ICarro>, res: Response) => {
    let validatedData: ICarro | undefined = undefined
    try{
        validatedData = await bodyValidation.validate(req.body)
        // validação acima
        console.log(req.body) // mostra o body da requisição
        res.json(validatedData) 
        // envia uma responsa json da validatedData (linha acima)
    } catch (err) {
        const yupErr = err as yup.ValidationError 
        // em caso de erro, a yup tem tratamento de erros próprio
        console.log("Erro: ", err)
        res.json({
            errors: {
                default: yupErr.message, // mensagem de erro
            }
        })  
    }
}


//Rota
router.post('/carros', post)

Exemplos de body

// ✅ Esse objeto passaria na validação
{
  modelo: "Civic",
  ano: 2020,
  cor: "Prata",
  fabricante: "Honda",
  placa: "ABC-1234",
  modificacao: ["turbo", "rodas esportivas"]
};

// ❌ Esse objeto NÃO passaria na validação
{
  model: "Fusca", // model errado, deveria ser modelo
  ano: 1800, // ano inválido
  cor: "", // cor vazia
  fabricante: "Volkswagen",
  placa: "123-ABCD", // placa em formato inválido
  modificacao: ["", 123] // contém string vazia e um número (o schema espera só strings)
};

💻 Conclusão

Dessa forma, podemos realizar a validação dos campos com muito mais eficiência, velocidade e práticidade. A yup permite que tenhamos um código bem mais limpo e organizado, habilidade essencial para um bom desenvolvedor.

📚 O que aprendemos?

Boas práticas ao lidar com validações
Utilizar a Biblioteca Yup
Implementar a biblioteca Yup em método de API

🎓 Referêcias

A biblioteca da yup é muito completa, entre na documentação e aprofunde seus conhecimentos

NPM
github/yup

🧑‍💻 Autor

Matheus Patricio

Onde me achar?

Linkedin
Github
portfólio

🙏 Agradecimentos

Se você ficou até aqui, agradeço de coração.
Até mais!

Variaveis de Ambiente em Node.js (.env)

Matheus Patricio — Mon, 14 Apr 2025 16:32:17 +0000

Quando desenvolvemos alguma aplicação backend, precisamos tomar cuidado ao lidar com informações sensíveis.

Informações como URL de conexão de banco de dados, senha do banco, chaves secretas, tokens e entre outras variáveis, se expostas podem gerar falhas de segurança críticas em nossa aplicação.

Para solucionar esse problema de exposição, podemos armazenar essas informações em variáveis de ambiente

Criando variável de ambiente em NodeJS

Para criar uma variável de ambiente, crie um arquivo na pasta raiz do seu projeto/aplicação com o nome de .env. Esse arquivo será responsável por guardar aquelas informações sensíveis e NÃO deve ser versionado.

exemplo de como o .env deve ficar:

APP_NAME=Meu app

SECRET_API=

# Servidor
PORT=3000

# Banco de dados
DB_NAME=seuBanco
DB_PASS=suaSenha
DB_HOST=localhost

A partir desse arquivo podemos ter noção de algumas regras:

A estrutura é CHAVE=VALOR
A chave é em caixa alta por padrão e em SNAKE_CASE
Todo valor retornado sempre será string, independente do tipo digitado
Uma chave pode ser vazia, e retorna uma string vazia

Agora que adicionamos as informações secretas dentro do nosso arquivo .env precisamos adicionar o pacote dotenv ao nosso projeto para que possamos gerenciar as variáveis de ambiente dentro do projeto.

Instalação do pacote dotenv

usando npm:

npm install dotenv

usando yarn:

yarn add dotenv

Em seguida inicializamos o pacote para que ele leia o arquivo .env:

import 'dotenv/config';
// ou então
import dotenv from 'dotenv';
dotenv.config();

Agora usaremos a ferramenta process.env, nativa do node, para substituir os valores no local de cada chave adicionada ao .env. Utilizando process.env.[NOME_DA_CHAVE]

Exemplo com a porta do servidor:

import express from 'express'
// Servidor

const server = express()

server.listen(process.env.PORT, () => {
    console.log("Servidor rodando!")
})

Boas práticas

Importante relembrar que o arquivo .env NÂO deve ser versionado, portanto se for subir o código no github, lembre-se de adicionar o arquivo ao gitignore para ele não enviar o arquivo para o seu repositório.

Outra boa prática, é criar um arquivo de exemplo com as chaves sem os valores sensiveis, assim quem clonar seu repositório não ficará perdido.

Eu crio um arquivo .env.example com apenas chaves.

Agradecimentos

Se você ficou até aqui, agradeço de coração.
Até mais!

Referencias

Fique a vontade para ler as documentações e aprofundar seus conhecimentos!

dotenv repo
dotenv - npm
Node process docs