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

> O que um PMS pode fazer com a Tatallo hoje e o que ainda está por vir.

A **API PMS Tatallo** permite que um sistema de gestão de propriedades (PMS) veja as propriedades Tatallo que os seus anfitriões ligaram a ele. É uma API servidor a servidor: o seu PMS chama a Tatallo com uma credencial PMS emitida pela Tatallo, e a Tatallo responde em JSON.

## Para quem é

Engenheiros de fornecedores de PMS que queiram mapear os anúncios dos seus anfitriões para propriedades Tatallo. Se é anfitrião, peça à Tatallo para ligar as suas propriedades ao seu PMS: a equipa Tatallo liga cada uma com o seu acordo.

## O que pode fazer hoje

A versão 1 é uma API pequena, só de leitura. Com uma credencial PMS pode:

* Verificar se a Tatallo está acessível (`GET /v1/health`).
* Ver a que conta, ambiente e âmbitos pertence a sua credencial PMS (`GET /v1/me`).
* Listar as propriedades que os seus anfitriões ligaram ao seu PMS (`GET /v1/properties`).
* Ler uma dessas propriedades (`GET /v1/properties/{propertyId}`): o ID permanente, nome, fuso horário IANA, estado, país, cidade, número máximo de hóspedes, moeda e hora da última atualização.

Uma propriedade só é visível para a sua credencial depois de o respetivo anfitrião a ter ligado ao seu PMS. Tudo o resto responde como se não existisse.

Existem dois servidores: **produção** (`https://api.tatallo.com`) e **staging** (`https://staging.api.tatallo.com`). O staging contém apenas propriedades sintéticas, para poder desenvolver e testar sem tocar em anúncios reais.

> [!WARNING]
>
> **Ainda não disponível:** unidades, ARI (disponibilidade, tarifas e restrições), cotações, reservas e webhooks. Estão planeados, mas hoje não fazem parte do contrato da API. Não construa integrações com base neles até aparecerem na referência da API.

## Obter acesso

Peça acesso em [Pedir acesso](https://tatallo-docs.mintlify.site/pt/get-started/access.md): comece pelo staging e peça produção depois da primeira chamada bem-sucedida em staging. A Tatallo analisa cada pedido e entrega cada PMS credential por um link secreto de uso único, nunca por e-mail. Para suporte, escreva para [hello@tatallo.com](mailto:hello@tatallo.com).


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