Webhooks

Webhooks são callbacks HTTP que permitem que a Certta envie notificações em tempo real para sua aplicação quando eventos específicos ocorrem. Esse método de comunicação assíncrona garante que seu sistema permaneça atualizado sem a necessidade de consultar nossas APIs constantemente.

Tópicos

• Criando Webhooks
• Gerenciando Webhooks
• Eventos
• Solicitação
• Assinatura

Visão geral

Webhooks fornecem um mecanismo para a Certta notificar seus sistemas quando eventos acontecem, em vez de exigir que sua aplicação consulte alterações. Quando um evento ocorre, a Certta envia uma solicitação HTTP POST para a URL do endpoint configurado com informações sobre o evento.

Primeiros passos

Para começar a usar webhooks com o Connect:

1. Configure seu endpoint de webhook - Crie um endpoint HTTPS que possa receber solicitações POST
2. Crie e configure seu webhook - Use o portal Trust para configurar seu webhook com os eventos e a autenticação apropriados
3. Implemente a verificação de assinatura - Verifique a autenticidade do webhook usando as assinaturas fornecidas
4. Trate os eventos do webhook - Processe os payloads formatados em CloudEvents na sua aplicação

A interface de gerenciamento de webhooks permite que você:

• Crie novos webhooks com filtragem personalizada de eventos
• Configure métodos de autenticação (Nenhum, Autenticação Básica ou Chave de API)
• Ative/desative webhooks conforme necessário
• Visualize o status dos webhooks e gerencie as configurações existentes

Segurança

Todas as solicitações de webhook são assinadas usando uma assinatura nos cabeçalhos, permitindo que você verifique se a solicitação se originou da Certta. Consulte Assinatura para mais detalhes sobre como verificar a autenticidade do webhook.