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.
Suas ferramentas, acesso com escopo
As chaves de API só recebem as permissões que você escolhe
O que faz
Saiba o que circula e o que fica onde está
As setas descrevem a direção dos dados em relação ao Sixto.
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.
Como funciona
- 01
Um Proprietário cria uma chave em Configurações e marca as permissões necessárias. A chave é mostrada uma vez.
- 02
Envie como token Bearer. Chame whoami e capabilities para ver o que a chave pode fazer.
- 03
Leia ou escreva pelos endpoints. As escritas passam pelas mesmas conferências do app.
- 04
Acompanhe as chamadas na tela de atividade da API e revogue uma chave quando quiser.
O que sincroniza
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.

