1. Inicio
  2. Documentos
  3. API y Webhooks
  4. Documentación Webhooks

Documentación Webhooks

Para usar los webhooks primero necesitamos un servidor capaz de procesar las llamadas que se recibirán del servidor de Berrly. Este servidor ha de proporcionar una URL con HTTPS válida y accesible desde el exterior.

ejemplo: https://www.example.com/webhooks/members

Podemos crear una URL por tipo de eventos que hemos de recibir. En este caso los modelos de datos dentro de Berrly.

Cuando se produzcan determinados eventos se recibirá una llamada a la URL que hayas introducido.

Eventos disponibles para el modelo Members (socios): create, update, delete, subscribe y unsubscribe.

Formato del webhook recibido:

{"event":"delete","timestamp":1592384708,"model":"member","id":12345}

Para verificar que el webhook se recibe de una fuente confiable se enviará dentro del header de la petición un parámetro signature.

ejemplo: signature recibida por el header:

459ad0f4cd78ecca7b6cadc5b967c46a9a3041fe0068ca2b16e88b199f02a88

código de ejemplo en PHP:

<?php 
$computedSignature = hash_hmac('sha256', '{"event":"delete","timestamp":1592384708,"model":"member","id":42788}', 'secretkey1234567890');

La variable $computedSignature ha de contener el mismo valor que la firma recibida. En caso contrario este webhook procede de una fuente no fiable.