Sixto API：与你的团队相同的操作和权限
Sixto API 通过仅拥有你授予权限的密钥，开放任务、记录、报告、消息等应用内操作。每次调用都记录在该密钥的活动日志中。密钥可以查询自己的身份及可执行的操作。敏感操作等待人员确认。
可用。带版本号的 REST API 和权限受限密钥涵盖预订、住客、任务、财务、入住登记、门锁、渠道等功能。
你的工具，受限访问
API 密钥只获得你选择的权限
功能介绍
了解哪些数据会传输，哪些保留原处
箭头表示数据相对于 Sixto 的传输方向。
广泛的功能覆盖
任务、预订、住客、评价、消息、入住登记、合规、门锁、渠道、电子发票、银行与总账、市场基准、搜索和设置。
从统一权限目录创建受限密钥
密钥与人员使用同一权限目录。若要更改权限，所有者需要创建替代密钥并撤销旧密钥。撤销从下一次调用起生效。
自我描述能力
向 API 查询你的身份与可执行操作（whoami 和 capabilities），包括每条路径所需的权限。
安全重试和活动日志
每项写入操作都说明其重试标识，例如 external_id 或 Idempotency-Key 标头。同一标识用于不同内容时返回 409。每个请求都有 ID，并出现在活动日志中。
公平的限制
每个密钥都有自己的额度，默认每分钟 600 次请求，因此一个繁忙的密钥不会拖慢另一个。GET /api/v1/capabilities 会报告当前额度。
更喜欢 AI 应用？使用 MCP
除 REST API 外，Sixto 还提供使用 OAuth 登录的 AI 应用 MCP 服务器，需由组织所有者或组织管理员开启后才能使用；另有公开只读的文档 MCP。
- 服务器地址
https://holasixto.com/mcp- 文档 MCP
https://holasixto.com/mcp/docs公开且只读，仅搜索 Sixto 文档，绝不访问您组织的数据。
运作方式
- 01
所有者在“设置”中创建密钥并勾选所需权限。密钥只显示一次。
- 02
将其作为 Bearer 令牌发送。调用 whoami 和 capabilities 查看密钥可执行的操作。
- 03
通过端点读取或写入。写入操作经过与应用相同的检查。
- 04
在 API 活动视图中查看调用，并随时撤销密钥。
同步内容
常见问题
有开发者指南吗？
有。OpenAPI 3.1 参考文档位于 /api/v1/openapi.json，客户端指南位于 /api/v1/guide.json。每项操作显示 x-contract-status：complete 表示经过审核的契约；unsupported 表示该路径仍可用，但不属于受支持的客户端接口。只读文档服务器位于 /mcp/docs。
密钥以谁的身份操作？
密钥代表组织并在其自身权限范围内操作。它没有自己的房源列表，也不继承创建者的房源限制。当 Sixto 通过 Sixto-On-Behalf-Of 委托转发个人请求时，还会应用该人当前的房源和权限限制。
如何更改密钥权限？
使用需要的权限创建替代密钥，让工具切换到新密钥，再撤销旧密钥。现有密钥不可编辑。已撤销的密钥在下一次调用时会被拒绝。
422 和 429 是什么意思？
422 表示校验失败：按字段阅读 errors 对象，修正输入后重新提交。429 表示密钥达到限额：等待 Retry-After 标头指定的秒数，再逐步延长间隔重试。保留 X-Request-Id，以便在活动日志中找到调用。
密钥可以开门吗？
不可以。API 绝不提供远程开门功能。
API 有版本号吗？
有，路径位于 /api/v1 下。