Sixto APIDisponível

API do Sixto: as mesmas ações e permissões que a sua equipe usa

A API do Sixto expõe as mesmas ações que o app usa: tarefas, registros, relatórios, mensagens e mais, com chaves que só têm os alcances que você concede. Cada chamada fica no registro de atividade da chave. Uma chave pode consultar o que pode fazer e quem é. As ações sensíveis esperam a confirmação de uma pessoa.

Disponível. Uma API REST versionada, com chaves de escopo definido, cobre reservas, hóspedes, tarefas, finanças, check-in, fechaduras, canais e mais.

Sixto Sixto API
FLUXO DA CONEXÃO

Suas ferramentas, acesso com escopo

As chaves de API só recebem as permissões que você escolhe

Sua ferramentaChave de API com escopo
API do SixtoConferência de permissões
Registro de atividadeRastreie a ação
Fluxo ilustrativo. É um exemplo, não a tela de uma conta real.
[ O QUE FAZ ]

O que faz

Sixto Sixto API
FLUXO DA CONEXÃO

Saiba o que circula e o que fica onde está

As setas descrevem a direção dos dados em relação ao Sixto.

Para o SixtoDados que você lê
Do SixtoMudanças que você faz
Fluxo ilustrativo. É um exemplo, não a tela de uma conta real.
  • Cobertura ampla

    Tarefas, reservas, hóspedes, avaliações, mensagens, check-in, conformidade, fechaduras, canais, faturas eletrônicas, banco e livro-razão, referências de mercado, busca e configurações.

  • Chaves com escopo, de um só catálogo de permissões

    As chaves usam o mesmo catálogo de permissões das pessoas. Para mudar permissões, um Proprietário cria uma chave substituta e revoga a anterior. A revogação vale para a próxima chamada.

  • Autodescritiva

    Pergunte à API quem você é e o que pode fazer (whoami e capabilities), inclusive as permissões exigidas de cada rota.

  • Novas tentativas seguras e um registro de atividade

    Cada escrita documenta sua identidade de nova tentativa, como external_id ou o cabeçalho Idempotency-Key, e responde 409 se a mesma identidade for reutilizada com outro conteúdo. Cada requisição tem um ID e aparece no registro de atividade.

  • Limites justos

    Cada chave tem sua própria cota, 600 requisições por minuto por padrão, então uma chave ocupada nunca atrasa outra. GET /api/v1/capabilities informa o valor atual.

Prefere um app de IA? Use MCP

Além da API REST, o Sixto tem um servidor MCP para apps de IA, com login OAuth e desligado até que um Proprietário ou Gerente o ative, e um MCP de documentação público e somente leitura.

Endereço do servidor
https://sixto.app/mcp
MCP de documentação
https://sixto.app/mcp/docsPúblico e somente leitura. Pesquisa a documentação do Sixto e nunca vê os dados da sua organização.
Conectar apps de IA (MCP)
[ COMO FUNCIONA ]

Como funciona

  1. 01

    Um Proprietário cria uma chave em Configurações e marca as permissões necessárias. A chave é mostrada uma vez.

  2. 02

    Envie como token Bearer. Chame whoami e capabilities para ver o que a chave pode fazer.

  3. 03

    Leia ou escreva pelos endpoints. As escritas passam pelas mesmas conferências do app.

  4. 04

    Acompanhe as chamadas na tela de atividade da API e revogue uma chave quando quiser.

[ DADOS ]

O que sincroniza

DadosDireçãoDetalhes
Dados que você lêPara o SixtoDo Sixto para a sua ferramenta, só o que a chave pode ver. Dados de contato e números de documento do hóspede ficam ocultos.
Mudanças que você fazDo SixtoDa sua ferramenta para o Sixto, como ações auditadas.
[ PRIVACIDADE ]

Permissões e privacidade

  • Permissões sensíveis nunca vêm ligadas em uma chave por padrão, e algumas nunca podem ser dadas a uma chave (por exemplo, abertura remota e gerenciar integrações ou membros da equipe).

  • Os valores dos códigos de porta, os números de documento do hóspede e os dados de contato sem máscara precisam da própria permissão, não vêm nas respostas padrão, e cada uso fica registrado.

  • As chaves ficam guardadas como hashes, então o Sixto não consegue mostrar uma chave de novo depois que você a cria.

[ PERGUNTAS ]

Perguntas frequentes

Existe um guia para desenvolvedores?

Sim. A referência OpenAPI 3.1 está em /api/v1/openapi.json e o guia para clientes em /api/v1/guide.json. Cada operação indica x-contract-status: complete significa um contrato revisado, unsupported significa que a rota continua disponível, mas fica fora da superfície suportada para clientes. Um servidor de documentação somente leitura está em /mcp/docs.

Em nome de quem uma chave age?

Uma chave age pela organização, dentro das próprias permissões. Ela não tem lista própria de propriedades e não herda os limites de propriedade de quem a criou. Quando o Sixto encaminha o pedido de uma pessoa com uma delegação Sixto-On-Behalf-Of, os limites atuais de propriedade e permissões dessa pessoa também se aplicam.

Como mudo as permissões de uma chave?

Crie uma chave substituta com as permissões desejadas, troque sua ferramenta para ela e depois revogue a chave anterior. Chaves existentes não podem ser editadas. Uma chave revogada é recusada na próxima chamada.

O que significam 422 e 429?

422 significa que a validação falhou: leia o objeto errors por campo, corrija os dados e envie de novo. 429 significa que a chave atingiu o limite: espere os segundos do cabeçalho Retry-After e tente de novo com espera progressiva. Guarde o X-Request-Id para encontrar a chamada no registro de atividade.

Uma chave pode abrir uma porta?

Não. A abertura remota nunca está disponível pela API.

A API tem versão?

Sim, ela fica em /api/v1.

Conecte o que você usa. Deixe de fora o que não precisa.