Output HTTP
Envia cada mensagem como uma requisição para uma URL. É o Output usado para chamar a API de outro sistema — um webhook, um endpoint de integração, um serviço interno.
Entrega uma mensagem por requisição, assim que ela chega. Não há acúmulo em lote.
Campos
| Campo | O que é | Padrão |
|---|---|---|
| URL destino | O endereço completo que vai receber a requisição, incluindo https://. Ex.: https://api.exemplo.com/webhook. | — |
| Método | Verbo HTTP da requisição: POST, PUT ou PATCH. | POST |
O que este Output precisa ler do tópico
| Parte | Como é usada |
|---|---|
| Value | Vira o corpo da requisição, byte a byte |
| Key | Não é usada |
| Headers | Viram cabeçalhos HTTP da requisição, um a um |
Este Output aceita qualquer mensagem. Não há formato obrigatório.
Exemplo
Mensagem lida do tópico:
Key: {"pedido":1234}
Value: {"pedido":1234,"cliente":"ACME","total":199.90}
Headers: Content-Type=application/json
X-Origem=erp-vendas
Requisição enviada (com URL destino https://api.exemplo.com/webhook e Método POST):
POST /webhook HTTP/1.1
Host: api.exemplo.com
Content-Type: application/json
X-Origem: erp-vendas
{"pedido":1234,"cliente":"ACME","total":199.90}
Repare que a Key foi ignorada e que os headers da mensagem viraram cabeçalhos da requisição. Se você precisa de um cabeçalho fixo (um token, por exemplo), o caminho é um Transform que o adicione aos headers da mensagem.
Uma mensagem de Value vazio faz a requisição sair com corpo vazio — veja Mensagens de Value vazio.
Quando a requisição falha
Uma resposta de erro do sistema de destino faz a mensagem não ser confirmada — ela será reenviada. Isso protege contra perda de dado, mas significa que um destino permanentemente fora do ar trava a fila naquele ponto. O acúmulo aparece como lag crescente na observabilidade.