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

> Ce qu'un PMS peut faire avec Tatallo aujourd'hui, et ce qui reste à venir.

L'**API PMS Tatallo** permet à un système de gestion des propriétés (PMS) de voir les propriétés Tatallo que ses hôtes ont connectées. Il s'agit d'une API de serveur à serveur : votre PMS appelle Tatallo avec une credential PMS émise par Tatallo, et Tatallo répond en JSON.

## À qui s'adresse-t-elle

Aux ingénieurs des éditeurs de PMS qui souhaitent faire correspondre les annonces de leurs hôtes aux propriétés Tatallo. Si vous êtes un hôte, demandez à Tatallo de connecter vos propriétés à votre PMS : l'équipe Tatallo les connecte une par une, avec votre accord.

## Ce que vous pouvez faire aujourd'hui

La version 1 est une petite API en lecture seule. Avec une credential PMS, vous pouvez :

* Vérifier que Tatallo est joignable (`GET /v1/health`).
* Voir à quel compte, environnement et scopes appartient votre credential PMS (`GET /v1/me`).
* Lister les propriétés que vos hôtes ont connectées à votre PMS (`GET /v1/properties`).
* Lire l'une de ces propriétés (`GET /v1/properties/{propertyId}`) : son identifiant permanent, son nom, son fuseau horaire IANA, son statut, son pays, sa ville, le nombre maximal d'invités, sa devise et la date de dernière mise à jour.

Une propriété n'est visible pour votre credential qu'après que son hôte l'a connectée à votre PMS. Tout le reste reçoit la même réponse que s'il n'existait pas.

Deux serveurs existent : **production** (`https://api.tatallo.com`) et **staging** (`https://staging.api.tatallo.com`). Le staging ne contient que des propriétés synthétiques, afin que vous puissiez développer et tester sans toucher à de vraies annonces.

> [!WARNING]
>
> **Pas encore disponible :** unités, ARI (disponibilités, tarifs et restrictions), devis, réservations et webhooks. Ils sont prévus, mais ne font pas partie du contrat de l'API aujourd'hui. Ne construisez pas dessus tant qu'ils n'apparaissent pas dans la référence API.

## Obtenir l'accès

Demandez l'accès depuis [Demander l'accès](https://tatallo-docs.mintlify.site/fr/get-started/access.md) : commencez par le staging, puis demandez la production après votre premier appel réussi en staging. Tatallo examine chaque demande et transmet chaque PMS credential par un lien secret à usage unique, jamais par e-mail. Pour le support, écrivez à [hello@tatallo.com](mailto:hello@tatallo.com).


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