Vacanze Sicure · Pianeta Vacanze Sicure
API, feed e integrazioni
Canali di interoperabilità per redazioni, motori, aggregatori e partner autorizzati. Le API pubbliche editoriali restano separate dalle API operative di distribuzione e prenotazione.
API contenuti v1
GET /api/v1/publications.php
Pubblicazioni pubbliche, filtri territoriali e metadati.
Partner Booking API
Catalogo risorse, disponibilità, hold temporaneo e prenotazioni per client autorizzati.
RESOURCE → AVAILABILITY → HOLD → BOOKING
Feed aperti
Sitemap
Interoperabilità
Partner Distribution & Booking
Il contratto Partner API supporta un modello uniforme per risorse prenotabili di categorie differenti. La documentazione pubblica descrive soltanto ciò che serve allo sviluppatore esterno: autenticazione, scope, endpoint, campi, esempi, codici HTTP, versionamento e onboarding.
| Fase | Funzione pubblicamente documentata |
|---|---|
| Catalogo | Leggere le risorse abilitate per il client e i dati necessari alla distribuzione. |
| Disponibilità | Ricercare intervallo, località, categoria, quantità ed extra. |
| Hold | Creare un blocco temporaneo prima della conferma. |
| Booking | Confermare un hold, leggere lo stato e richiedere la cancellazione quando consentita. |
Vai alla documentazione Partner API completa →
Principi di utilizzo
| Principio | Regola |
|---|---|
| Fonte | Conservare l'attribuzione della fonte originaria quando presente. |
| URL | Per le pubblicazioni usare canonical_url come collegamento principale alla pagina VS. |
| Aggiornamenti | Le date e gli stati devono riflettere modifiche effettive e non aggiornamenti artificiali. |
| Scrittura | L'API editoriale pubblica è read-only; le scritture operative richiedono un client partner autorizzato. |
| Dati | Scambiare solo i dati necessari alla funzione autorizzata. |
Per VìSì
La pubblicazione di specifiche leggibili, canonicali e machine-readable rende più semplice comprendere quali servizi Vacanze Sicure rende interoperabili, senza esporre le informazioni riservate necessarie al funzionamento interno della piattaforma.