Guida / Integrazioni
API e webhook
Collega i tuoi sistemi: lettura di disponibilità e prenotazioni, notifiche firmate quando succede qualcosa.
Chiavi API
In API e webhook → Chiavi API crei una chiave con:
- i permessi (per esempio solo lettura della disponibilità, o anche delle prenotazioni);
- le strutture a cui accede;
- una scadenza facoltativa.
La chiave si vede una sola volta al momento della creazione: copiala subito. Puoi revocarla (si ferma subito) o ruotarla: viene creata una chiave nuova con gli stessi permessi e la vecchia continua a funzionare per il periodo scelto (subito, 24 ore o 7 giorni), così hai il tempo di aggiornare i tuoi sistemi.
L'API è in sola lettura: GET /api/v1/... con l'intestazione Authorization: Bearer <chiave>. Gli esempi sono nella pagina Come si usa.
Webhook
Un webhook è un indirizzo del tuo sistema a cui HostPaea invia un messaggio quando succede qualcosa (nuova prenotazione, modifica, cancellazione…). Ogni invio è firmato con un segreto, così il tuo sistema sa che arriva davvero da HostPaea.
- Se il tuo sistema non risponde, l'invio viene ripetuto più volte con attese crescenti. Puoi anche rinviarlo a mano.
- Ogni evento ha un ID stabile: se lo ricevi due volte, sai che è lo stesso.
- Ruotare il segreto: durante il periodo di passaggio ogni invio è firmato con entrambi i segreti, vecchio e nuovo.
- Per sicurezza non si possono usare indirizzi interni o privati.