Sixto APIDisponible

API de Sixto: las mismas acciones y permisos que usa tu equipo

La API de Sixto expone las mismas acciones que usa la app: tareas, registros, reportes, mensajes y más, con claves que solo tienen los alcances que les das. Cada llamada queda en el registro de actividad de la clave. Una clave puede consultar qué puede hacer y quién es. Las acciones sensibles esperan la confirmación de una persona.

Disponible. Una API REST versionada con llaves con permisos cubre reservas, huéspedes, tareas, finanzas, registro, cerraduras, canales y más.

Sixto Sixto API
FLUJO DE CONEXIÓN

Tus herramientas, acceso limitado

Las claves solo reciben los permisos que elijas

Tu herramientaClave de API con alcance limitado
API de SixtoVerificación de permisos
ActividadRastrea la acción
Flujo ilustrativo. Ejemplo, no es una cuenta en vivo.
[ QUÉ HACE ]

Qué hace

Sixto Sixto API
FLUJO DE CONEXIÓN

Qué se comparte y qué permanece igual

Las flechas indican la dirección de los datos respecto a Sixto.

Hacia SixtoDatos que lees
Desde SixtoCambios que haces
Flujo ilustrativo. Ejemplo, no es una cuenta en vivo.
  • Cobertura amplia

    Tareas, reservas, huéspedes, reseñas, mensajes, registro, cumplimiento, cerraduras, canales, facturas electrónicas, banco y libro contable, referencias de mercado, búsqueda y ajustes.

  • Llaves con permisos de un solo catálogo

    Las llaves usan el mismo catálogo de permisos que las personas. Para cambiar permisos, un Propietario crea una llave de reemplazo y revoca la anterior. La revocación se aplica a la siguiente llamada.

  • Se describe sola

    Pregúntale a la API quién eres y qué puedes hacer (whoami y capabilities), incluidos los permisos que requiere cada ruta.

  • Reintentos seguros y registro de actividad

    Cada escritura documenta su identidad de reintento, como external_id o el encabezado Idempotency-Key, y responde 409 si se repite la misma identidad con otro contenido. Cada solicitud tiene un ID y aparece en el registro de actividad.

  • Límites justos

    Cada llave tiene su propio cupo, 600 solicitudes por minuto por defecto, así que una llave ocupada nunca frena a otra. GET /api/v1/capabilities informa el valor actual.

¿Prefieres una app de IA? Usa MCP

Además de la API REST, Sixto tiene un servidor MCP para apps de IA, con inicio de sesión OAuth y apagado hasta que un Propietario o Gerente lo active, y un MCP de documentación público y de solo lectura.

Dirección del servidor
https://sixto.app/mcp
MCP de documentación
https://sixto.app/mcp/docsPúblico y de solo lectura. Busca en la documentación de Sixto y nunca ve los datos de tu organización.
Conectar apps de IA (MCP)
[ CÓMO FUNCIONA ]

Cómo funciona

  1. 01

    Un Propietario crea una llave en Configuración y marca los permisos que necesita. La llave se muestra una sola vez.

  2. 02

    Envíala como token Bearer. Llama a whoami y capabilities para ver qué puede hacer la llave.

  3. 03

    Lee o escribe mediante los endpoints. Las escrituras pasan por las mismas verificaciones que la app.

  4. 04

    Mira las llamadas en la vista de actividad de la API y revoca una llave cuando quieras.

[ DATOS ]

Qué se sincroniza

DatoSentidoDetalle
Datos que leesHacia SixtoDe Sixto a tu herramienta, solo lo que la llave puede ver. Los datos de contacto y los números de documento de los huéspedes están ocultos.
Cambios que hacesDesde SixtoDe tu herramienta a Sixto, como acciones auditadas.
[ PRIVACIDAD ]

Permisos y privacidad

  • Los permisos sensibles nunca vienen en una llave por defecto, y algunos no se le pueden dar nunca a una llave (por ejemplo la apertura remota y administrar integraciones o integrantes del equipo).

  • Los valores de códigos de puerta, los números de documento y los datos de contacto sin ocultar requieren su propio permiso, no están en las respuestas por defecto y cada uso queda registrado.

  • Las llaves se guardan como hashes, así que Sixto no puede mostrarte una llave de nuevo después de crearla.

[ PREGUNTAS ]

Preguntas frecuentes

¿Hay una guía para desarrolladores?

Sí. La referencia OpenAPI 3.1 está en /api/v1/openapi.json y la guía para clientes en /api/v1/guide.json. Cada operación indica x-contract-status: complete significa un contrato revisado, unsupported significa que la ruta sigue disponible pero queda fuera de la superficie soportada para clientes. Un servidor de documentación de solo lectura está en /mcp/docs.

¿En nombre de quién actúa una llave?

Una llave actúa por la organización, dentro de sus propios permisos. No tiene una lista de propiedades propia ni hereda los límites de propiedad de quien la creó. Cuando Sixto reenvía la solicitud de una persona con una delegación Sixto-On-Behalf-Of, también se aplican los límites actuales de propiedad y permisos de esa persona.

¿Cómo cambio los permisos de una llave?

Crea una llave de reemplazo con los permisos que quieres, cambia tu herramienta a ella y luego revoca la llave anterior. Las llaves existentes no se pueden editar. Una llave revocada se rechaza en su siguiente llamada.

¿Qué significan 422 y 429?

422 significa que la validación falló: lee el objeto errors por campo, corrige los datos y envía de nuevo. 429 significa que la llave llegó a su límite: espera los segundos del encabezado Retry-After y reintenta con espera progresiva. Guarda el X-Request-Id para encontrar la llamada en el registro de actividad.

¿Una llave puede abrir una puerta?

No. La apertura remota nunca está disponible por la API.

¿La API tiene versiones?

Sí, vive bajo /api/v1.

Conecta lo que usas. Deja lo que no.