Webhook
Invia eventi di lettura a qualsiasi URL tramite Webhook personalizzati. Perfetto per costruire automazioni e integrazioni personalizzate.

Schermata di configurazione Webhook
I Webhook ti consentono di ricevere notifiche in tempo reale sulla tua attività di lettura. Quando si verifica un evento, Book Reading Habit invia una richiesta HTTP POST con i dati dell'evento in formato JSON all'URL specificato.
Cosa sono i Webhook?
I Webhook ti consentono di ricevere notifiche in tempo reale sulla tua attività di lettura. Quando si verifica un evento, Book Reading Habit invia una richiesta HTTP POST con i dati dell'evento in formato JSON all'URL specificato.
Come funzionano i Webhook
Dopo aver configurato un URL Webhook, Book Reading Habit invierà automaticamente notifiche ogni volta che si verificano determinati eventi:
- Si verifica un evento in Book Reading Habit (es. sessione di lettura completata)
- L'app invia una richiesta HTTP POST all'URL del Webhook
- Il tuo server riceve il payload JSON e può elaborarlo come preferisci
Configurazione
Configura il tuo Webhook con le seguenti impostazioni:
Nome Webhook
Un nome per identificare questo Webhook
URL Webhook
L'URL a cui verranno inviate le richieste POST
Chiave segreta (opzionale)
Se specificata, le richieste includeranno un header X-Signature-256 con una firma HMAC per la verifica
Eventi
Scegli quali eventi attiveranno questo Webhook
Formato del payload
Tutti i payload Webhook vengono inviati come JSON con la seguente struttura:
{
"eventType": "session.completed",
"timestamp": "2024-12-04T10:30:00Z",
"book": { ... },
"session": { ... },
"metadata": null
}Scopri di più
Tipi di evento
Elenco completo dei 16 eventi a cui puoi iscriverti
Struttura del payload
Struttura dettagliata del payload Webhook con tutti i campi
Pratiche di sicurezza consigliate
Usa sempre URL HTTPS e imposta una chiave segreta per verificare le richieste Webhook. La chiave segreta viene usata per generare una firma HMAC che puoi verificare sul tuo server.