Para desarrolladores e integradores
Una API de reservas, y un servidor MCP encima.
Todo lo que hace el panel de gestión pasa por la misma API pública: disponibilidad, citas, clientes, servicios, recursos, horarios, pagos. No hay una API de segunda categoría.
La descripción OpenAPI completa se sirve en abierto, sin cuenta y sin formulario.
Lo primero que hay que leer
La autenticación es un token portador en la cabecera Authorization. Cada clave lleva permisos explícitos, y una clave pública de widget solo puede hacer lo que le está permitido a un visitante.
- https://sutempo.com/openapi.json : la descripción OpenAPI completa de la API, servida bajo /v1
- https://sutempo.com/.well-known/platform-capabilities.json : el manifiesto de capacidades de este despliegue
- https://sutempo.com/llms.txt : el mismo resumen, para un asistente
- https://sutempo.com/console : la consola que emite las claves de API, tras iniciar sesión
El camino más corto hasta una reserva
Leer la disponibilidad, retener el hueco mientras se paga, y confirmar después. El hueco nunca se calcula en el cliente: el servidor solo ofrece inicios posteriores a su reloj, y una retención impide que dos clientes tomen el mismo hueco.
curl -H "Authorization: Bearer $SUTEMPO_KEY" \
"https://sutempo.com/v1/business-tenants/$TENANT/availability?serviceId=$SERVICE&from=2026-10-01"
curl -X POST -H "Authorization: Bearer $SUTEMPO_KEY" \
-H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \
-d '{"serviceId":"...","startsAt":"2026-10-01T09:00:00Z"}' \
"https://sutempo.com/v1/business-tenants/$TENANT/appointments/hold"El servidor MCP
El paquete @platform/mcp-server expone la configuración de un negocio como herramientas para un agente. El contrato obliga a previsualizar antes de aplicar: un agente lee la configuración, propone un cambio, muestra sus efectos y solo entonces lo aplica.
No es una formalidad. La previsualización devuelve la lista de cambios destructivos, y la aplicación se rechaza si la configuración ha cambiado entre las dos llamadas.
- describe_capabilities, list_business_tenants, list_tenant_modules: lo que sabe hacer este despliegue
- get_current_blueprint, get_blueprint_version: el estado actual y su versión
- preview_blueprint_changes y después apply_blueprint_changes: proponer y aplicar
- schedule_group_sessions, cancel_group_session: las sesiones colectivas
- get_translation_status, set_translation_override: los idiomas de la página pública
Integrar la reserva en una web
Dos caminos, según lo que construyas. El widget integrable se coloca en una web existente con una clave pública y hereda el idioma de la página. El SDK de JavaScript y la API subyacente permiten construir el recorrido entero a tu manera, incluido el pago.
En ambos casos los pagos van a la cuenta de Stripe del negocio, nunca a una cuenta intermedia.
Preguntas frecuentes
¿La API se paga aparte?
No. El acceso a la API sigue la suscripción del negocio. No hay tarifa de desarrollador ni funciones recortadas respecto al panel de gestión.
¿Cómo consigo una clave?
Desde la consola de desarrollador, tras iniciar sesión en la cuenta del negocio. Las claves se crean, se rotan y se revocan por la API igual que por la consola.
¿Las escrituras son idempotentes?
Sí, aceptan una cabecera Idempotency-Key, lo que hace seguro reintentar tras un corte de red.
¿El servidor MCP puede modificar un negocio sin control?
No. El contrato obliga a llamar a la previsualización antes de aplicar, y la aplicación falla si la configuración ha cambiado mientras tanto.
¿Hay webhooks?
Sí. El envío de webhooks forma parte de la plataforma y se configura como el resto, por la API.
Empieza gratis.
Crear mi cuentaSolo es gratuito y no pide tarjeta. Établissement y Membership se prueban 30 días, y al final de la prueba el negocio vuelve a Solo sin perder nada.