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

> Qué puede hacer hoy un PMS con Tatallo y qué está todavía por llegar.

La **API PMS de Tatallo** permite a un sistema de gestión de propiedades (PMS) ver las propiedades de Tatallo que sus anfitriones han conectado. Es una API de servidor a servidor: tu PMS llama a Tatallo con una credencial PMS emitida por Tatallo, y Tatallo responde con JSON.

## Para quién es

Para ingenieros de proveedores de PMS que quieren asignar los anuncios de sus anfitriones a propiedades de Tatallo. Si eres anfitrión, pide a Tatallo que conecte tus propiedades a tu PMS: el equipo de Tatallo conecta cada una con tu acuerdo.

## Qué puedes hacer hoy

La versión 1 es una API pequeña y de solo lectura. Con una credencial PMS puedes:

* Comprobar que Tatallo está accesible (`GET /v1/health`).
* Ver a qué cuenta, entorno y scopes pertenece tu credencial PMS (`GET /v1/me`).
* Listar las propiedades que tus anfitriones han conectado a tu PMS (`GET /v1/properties`).
* Leer una de esas propiedades (`GET /v1/properties/{propertyId}`): su ID permanente, nombre, zona horaria IANA, estado, país, ciudad, máximo de huéspedes, moneda y fecha y hora de la última actualización.

Una propiedad es visible para tu credencial solo después de que su anfitrión la haya conectado a tu PMS. Cualquier otra responde como si no existiera.

Hay dos servidores: **producción** (`https://api.tatallo.com`) y **staging** (`https://staging.api.tatallo.com`). Staging solo contiene propiedades sintéticas, para que puedas desarrollar y probar sin tocar anuncios reales.

> [!WARNING]
>
> **Aún no disponible:** unidades, ARI (disponibilidad, tarifas y restricciones), cotizaciones, reservas y webhooks. Están previstos, pero no forman parte del contrato de la API hoy. No desarrolles contra ellos hasta que aparezcan en la referencia de la API.

## Obtener acceso

Solicita acceso desde [Solicitar acceso](https://tatallo-docs.mintlify.site/es/get-started/access.md): empieza por staging y pide producción tras tu primera llamada correcta en staging. Tatallo revisa cada solicitud y entrega cada PMS credential mediante un enlace secreto de un solo uso, nunca por correo. Para soporte, escribe a [hello@tatallo.com](mailto:hello@tatallo.com).


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