Pular para o conteúdo
AdiosDocumentação
Explorar a documentação

Crie e implante um processador de webhooks em Go

Crie um serviço Go que receba dados de webhooks de terceiros, valide-os e grave registros de eventos tratados em SQL.

A stack

  • Go com net/http ou Gin
  • Postgres ou MySQL
  • Um ambiente de execução persistente com pool de conexões nativo de Go
  • Roteamento, TLS, logs e controles de implantação do Adios

Por que um serviço Go persistente é adequado para webhooks

Um serviço Go compilado pode manter conexões de banco de dados abertas e validar assinaturas em um processo persistente. O Adios fornece o ambiente de execução, rota, TLS, logs, verificações de saúde e referências de segredos para esse processo.

1. Criar o handler

Peça ao agente de IA do Adios:

Build a Go webhook processor with POST /webhooks/:provider. Verify a shared
signature header, decode JSON, store events in Postgres, and expose /healthz.
Use context-aware database calls and tests for invalid signatures.

2. Adicionar adios.yaml

name: webhook-processor
region: de
replicas: 2

build_cmd: go build -o /app/webhook-processor ./cmd/server
start_cmd: /app/webhook-processor

runtime:
  name: go@1.25
  port: 8080
  health_path: /healthz
  memory_mb: 512

env:
  DATABASE_URL: secret://DATABASE_URL
  WEBHOOK_SECRET: secret://WEBHOOK_SECRET

requires:
  - db

3. Implantar

adios secrets set WEBHOOK_SECRET
adios up
adios logs --runtime

4. Testar a carga do handler

Use sua ferramenta preferida de teste de carga na rota gerada. Observe a latência das requisições, os logs de execução e as gravações no banco de dados. O objetivo é entender como um pequeno binário Go se comporta com tráfego real, em vez de perseguir um benchmark artificial.

Consulte a Caminho de implantação Go, compare a modelos de API Go, e use a Verificações de implantação PostgreSQL antes de adaptar o handler para eventos em produção.