# 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](/it/developers/webhooks) 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](/it/developers/badge).

## 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](/developers/openapi.json), con l’evento sotto `webhooks`.
* [llms.txt](/llms.txt) elenca le pagine; [llms-full.txt](/llms-full.txt) raccoglie i contenuti.
* Ogni pagina ha una versione Markdown: [/it/developers/webhooks.md](/it/developers/webhooks.md). L’indice è [/it/developers/index.md](/it/developers/index.md).