Ora puoi costruire direttamente su Veridien. Lo stesso motore che fa funzionare i nostri percorsi di prenotazione è aperto a te: un motore di prenotazione su misura, un'app mobile per gli ospiti, un'integrazione con un programma fedeltà o qualsiasi automazione di back office.
È una comune interfaccia HTTP/JSON. Ti autentichi con una chiave API legata a una singola struttura, invii e ricevi JSON in snake_case e ti affidi ai codici di stato standard e a un'unica struttura di errore uniforme. Ogni chiave ha i suoi ambiti, quindi può fare solo quello che le concedi, e solo sulla struttura a cui appartiene.
- Chiavi API per singola struttura. Crea, limita e revoca le chiavi in Impostazioni → Chiavi API. Le chiavi vengono mostrate una sola volta e conservate solo come hash.
- Accesso per ambiti. Dodici ambiti granulari (per esempio
availability:read,reservations:write,folio:write) proteggono ogni endpoint, incluso un ambitoguests:read:piiseparato per i dati personali sensibili degli ospiti. - L'intero ciclo di vita della prenotazione. Cerca la disponibilità, calcola il prezzo di un soggiorno con tariffe soggette a regole di visibilità, registra o collega un ospite, blocca la disponibilità, conferma una prenotazione pagata e registra gli addebiti sul conto.
- Programma fedeltà. Leggi il saldo e il livello di un ospite, riscatta i punti e accumulali automaticamente sui soggiorni confermati.
- Nuovi tentativi sicuri. Le richieste che modificano i dati accettano una
Idempotency-Key, così un nuovo tentativo di rete non prenota né addebita mai due volte. La conferma della prenotazione è inoltre idempotente sul suo riferimento di pagamento. - Errori prevedibili. Ogni errore restituisce una struttura tipizzata con un
codestabile, unparamfacoltativo e unrequest_id. - Schema OpenAPI 3.1. Una descrizione di ogni endpoint leggibile da una macchina viene servita su
/api/v1/openapi.jsonper generare client tipizzati.
| Area | Cosa puoi fare |
|---|---|
| Catalogo | Leggere la struttura, i tipi di camera, la disponibilità e i piani tariffari ammissibili |
| Ospiti | Registrare o collegare gli ospiti, leggere e aggiornare le schede, leggere il programma fedeltà |
| Prenotazioni | Bloccare la disponibilità, confermare le prenotazioni, elencarle e leggerle, annullare |
| Conti | Leggere il conto di una prenotazione e registrarci gli addebiti |
| Programma fedeltà | Leggere saldi e livelli, riscattare i punti |
Il riferimento completo, un avvio rapido ed esempi da copiare e incollare si trovano nella documentazione dell'API. L'URL di base è https://veridien.app/api/v1.