Webhooks baseados em eventos
Subscreva endpoints a eventos de ficheiros, serviços, formulários, assinaturas e processos.
Capacidade
Automação e webhooks
Ligue ações Cloud por API e webhooks assinados com histórico e novas tentativas.
Descrição
Ligue ações Cloud por API e webhooks assinados com histórico e novas tentativas.
Funcionalidades
O que Automação e webhooks permite fazer
Assinaturas HMAC
Verifique que os payloads vêm do Apification e não foram alterados.
Histórico de entregas
Consulte URL, data, estado e corpo da resposta de cada entrega.
Novas tentativas automáticas e manuais
Repita falhas temporárias segundo regras ou a partir do portal.
Operações dirigidas por API
Automatize contas, recursos Cloud e configuração suportados.
Comandos idempotentes
Evite que tentativas de rede repitam a mesma ação de negócio.
Processamento assíncrono
Execute importações, transformações e trabalhos de fornecedores em segundo plano.
Estados de erro detalhados
Associe erros de fornecedor, validação e processo ao trabalho que os gerou.
Estatísticas de uso e entrega
Meça execuções, entregas corretas ou falhadas, tentativas e consumo.
Ciclo do evento
Desenhar para verificar, repetir e recuperar
Uma automatização fiável trata a entrega como um processo com estado.
-
01 Escolher o evento
Subscreva apenas alterações que o recetor consiga processar.
-
02 Verificar o pedido
Valide HMAC antes de ler ou guardar o payload.
-
03 Processar com idempotência
Use identificadores estáveis contra ações duplicadas.
-
04 Observar e recuperar
Inspecione entregas e repita falhas temporárias.
Detalhe operacional
Como funciona Automação e webhooks na prática
A automatização combina comandos autenticados, eventos assinados, processamento em segundo plano e evidência operacional sem transformar novas tentativas em trabalho duplicado.
Os eventos precisam de contrato explícito
O recetor deve conhecer tipo, recurso, conta, momento e versão do payload antes de automatizar.
A entrega tem ciclo de vida
Tentativas, respostas, tempos e repetições ficam ligados para distinguir falhas temporárias e permanentes.
Comandos e trabalhos exigem tratamentos diferentes
A API pode aceitar um comando enquanto importações e transformações continuam em segundo plano.
A monitorização faz parte do fluxo
Sucesso, falhas repetidas, duração e consumo devem ser analisados em conjunto.
Perguntas frequentes
Perguntas sobre Automação e webhooks
O catálogo suportado cobre alterações relevantes do Cloud, processamento, entregas e ciclo de vida dos serviços.
Os pedidos webhook incluem uma assinatura gerada com o segredo configurado, permitindo verificar a sua autenticidade.
O registo guarda tentativas, estado, resposta e tempos para diagnóstico e novas tentativas controladas.
Não dependa apenas da chegada; use datas, estado do recurso e identificadores estáveis.
Depois de verificar e aceitar de forma durável; o processamento longo deve continuar assincronamente.
Guarde o identificador estável e torne a operação idempotente antes de responder.