Webhook: sottoscrizione eventi Welcome in tempo reale

Reference tecnico. Ultima revisione: 20 agosto 2026. Versione API: v1.

Il sistema webhook permette di ricevere notifiche push in tempo reale su eventi Welcome sottoscritti. Eventi disponibili: prenotazione.creata, prenotazione.modificata, prenotazione.annullata, checkin.effettuato, checkout.effettuato, pagamento.registrato, tariffa.aggiornata, disponibilita.cambiata. Il payload è firmato HMAC-SHA256 con secret condiviso, verificabile via header X-Passepartout-Signature. Retry con backoff esponenziale in caso di risposta non 200: 5 tentativi distribuiti su 24 ore. I webhook devono rispondere entro 5 secondi, oltre viene registrato timeout. La sottoscrizione si gestisce dal pannello Impostazioni → Webhook della tua area cliente, con configurazione per url endpoint, eventi sottoscritti, secret rotabile, ambiente (sandbox o produzione).

Esempio di richiesta

GET /v1/prenotazioni?data=2026-08-25&limit=50 HTTP/1.1
Host: api.passepartoutextensions.org
Authorization: Bearer <token>
Accept: application/json

Rate limit

600 richieste al minuto in fascia base, 3000 in fascia Enterprise. Header di risposta X-RateLimit-Remaining indica le richieste residue nel bucket corrente. In caso di superamento, risposta 429 con header Retry-After.