Documentazione tecnica
Integra StayParity con i tuoi sistemi tramite webhook firmati e aggiungi il widget per prenotazioni dirette al sito dell’hotel. Chiavi, eventi ed esempi.
StayParity offre webhook per notificare al tuo server le nuove discrepanze e un widget per mostrare la tariffa diretta sul sito dell’hotel.
Webhook
Quando un controllo rileva una tariffa OTA inferiore a quella diretta e sono soddisfatti i criteri di notifica, inviamo un evento JSON firmato al tuo endpoint. Puoi usarlo per creare un’attività o alimentare i rapporti.
La firma segue Standard Webhooks. Consulta Webhook per formato, verifica, nuovi tentativi e test.
Widget per prenotazioni dirette
Un tag <script> aggiunge la tariffa diretta alla pagina di prenotazione. Mostra le tariffe OTA se l’hotel è il più economico o eguaglia il minimo; se un’OTA costa meno, mostra solo la tariffa diretta senza dichiararla la migliore.
Consulta l’integrazione del widget.
Chiavi
| Chiave | Prefisso | Posizione nell’applicazione | Segreta? |
|---|---|---|---|
| Firma | whsec_… | Settings → Webhooks, una per account | Sì. Conservala sul server. |
| Integrazione | wk_… | Settings → Website badge, una per hotel | No. Compare nell’HTML pubblico. |
Solo gli amministratori possono creare o sostituire la chiave di firma. Viene mostrata una volta e permette di verificare l’origine del webhook.
La chiave di integrazione mostra il confronto pubblico dell’hotel e può essere copiata dai visitatori. Replace snippet genera una nuova chiave; quella precedente viene rifiutata alla successiva richiesta senza cache. Il widget salvato nel browser può restare visibile fino a cinque minuti.
Non esiste ancora un’API pubblica per leggere o modificare i dati dell’account. I webhook inviano eventi al server e il widget legge il confronto pubblico. Nessuno dei due richiede un token API.
Formati per strumenti
- Contratto OpenAPI 3.1, con l’evento sotto
webhooks. - llms.txt elenca le pagine; llms-full.txt raccoglie i contenuti.
- Ogni pagina ha una versione Markdown: /it/developers/webhooks.md. L’indice è /it/developers/index.md.