Skip to main content
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.
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: 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.