Webhooks
Envía eventos de lectura a cualquier URL con webhooks personalizados. Perfecto para construir tus propias automatizaciones e integraciones.
Pantalla de configuración de webhook
Los webhooks te permiten recibir notificaciones en tiempo real sobre tu actividad de lectura. Cuando ocurre un evento, Book Reading Habit envía una solicitud HTTP POST a tu URL especificada con datos del evento en formato JSON.
¿Qué son los Webhooks?
Los webhooks te permiten recibir notificaciones en tiempo real sobre tu actividad de lectura. Cuando ocurre un evento, Book Reading Habit envía una solicitud HTTP POST a tu URL especificada con datos del evento en formato JSON.
Cómo Funcionan los Webhooks
Cuando configuras una URL de webhook, Book Reading Habit enviará automáticamente notificaciones cuando ocurran ciertos eventos:
- Ocurre un evento en Book Reading Habit (ej., completas una sesión de lectura)
- La app envía una solicitud HTTP POST a tu URL de webhook
- Tu servidor recibe la carga JSON y puede procesarla como quieras
Configuración
Configura tu webhook con los siguientes ajustes:
Nombre del Webhook
Un nombre amigable para identificar este webhook
URL del Webhook
La URL donde se enviarán las solicitudes POST
Clave Secreta (Opcional)
Si se proporciona, las solicitudes incluirán un encabezado X-Signature-256 con una firma HMAC para verificación
Eventos
Selecciona qué eventos deben activar este webhook
Formato de Carga
Todas las cargas de webhook se envían como JSON con la siguiente estructura:
{
"eventType": "session.completed",
"timestamp": "2024-12-04T10:30:00Z",
"book": { ... },
"session": { ... },
"metadata": null
}Más Información
Tipos de Eventos
Lista completa de los 16 eventos a los que puedes suscribirte
Estructura de Carga
Estructura detallada de las cargas de webhook con todos los campos
Mejores Prácticas de Seguridad
Siempre usa URLs HTTPS y configura una clave secreta para verificar las solicitudes de webhook. La clave secreta se usa para generar una firma HMAC que puedes verificar en tu servidor.