Vai al contenuto principale
Questa pagina è stata tradotta tramite IA e potrebbe contenere errori.

Webhook

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

Book Reading Habit app showing webhook configuration screen

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ù

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.