Che cosa un PMS può fare con Tatallo oggi, e che cosa deve ancora arrivare.
L’API PMS Tatallo consente a un sistema di gestione delle proprietà (PMS) di vedere le proprietà Tatallo che i suoi host hanno collegato. È un’API da server a server: il tuo PMS chiama Tatallo con una credenziale PMS emessa da Tatallo, e Tatallo risponde in JSON.
Agli sviluppatori dei fornitori di PMS che vogliono associare gli annunci dei propri host alle proprietà Tatallo. Se sei un host, chiedi a Tatallo di collegare le tue proprietà al tuo PMS: lo staff Tatallo le collega una per una, con il tuo consenso.
La versione 1 è un’API piccola, in sola lettura. Con una credenziale PMS puoi:
Verificare che Tatallo sia raggiungibile (GET /v1/health).
Vedere a quale account, ambiente e scope appartiene la tua credenziale PMS (GET /v1/me).
Elencare le proprietà che i tuoi host hanno collegato al tuo PMS (GET /v1/properties).
Leggere una di quelle proprietà (GET /v1/properties/{propertyId}): ID permanente, nome, fuso orario IANA, stato, Paese, città, numero massimo di ospiti, valuta e ora dell’ultimo aggiornamento.
Una proprietà è visibile alla tua credenziale solo dopo che il suo host l’ha collegata al tuo PMS. Tutto il resto riceve la stessa risposta di ciò che non esiste.I server sono due: produzione (https://api.tatallo.com) e staging (https://staging.api.tatallo.com). Lo staging contiene solo proprietà sintetiche, così puoi sviluppare e fare prove senza toccare annunci reali.
Non ancora disponibile: unità, ARI (disponibilità, tariffe e restrizioni), preventivi, prenotazioni e webhook. Sono previsti, ma oggi non fanno parte del contratto dell’API. Non basare l’integrazione su di essi finché non compaiono nel riferimento API.
Richiedi l’accesso da Richiedi l’accesso: comincia dallo staging, poi chiedi la produzione dopo la prima chiamata riuscita in staging. Tatallo esamina ogni richiesta e consegna ogni credenziale PMS tramite un link segreto monouso, mai via email. Per assistenza scrivi a hello@tatallo.com.
