> ## Documentation Index
> Fetch the complete documentation index at: https://tatallo-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API PMS Tatallo

> 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.

## A chi è rivolta

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.

## Che cosa puoi fare oggi

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.

> [!WARNING]
>
> **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.

## Ottenere l'accesso

Richiedi l'accesso da [Richiedi l'accesso](https://tatallo-docs.mintlify.site/it/get-started/access.md): 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](mailto:hello@tatallo.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.