La API de reservas para desarrolladores y agencias.

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 de desarrollador, con su sandbox, sus claves de prueba y un inicio rápido en tres pasos

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/services"

curl -H "Authorization: Bearer $SUTEMPO_KEY" \
  "https://sutempo.com/v1/business-tenants/$TENANT/availability/search?serviceId=$SERVICE&locationId=$LOCATION&from=2026-10-01&to=2026-10-07"

curl -X POST -H "Authorization: Bearer $SUTEMPO_KEY" \
  -H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" \
  -d '{"locationId":"...","serviceId":"...","resourceId":"...","startsAt":"2026-10-01T09:00:00Z"}' \
  "https://sutempo.com/v1/business-tenants/$TENANT/appointments/hold"

El servidor MCP

El servidor MCP expone la configuración de un negocio como herramientas para un agente. No lee ni modifica las reservas, los clientes ni los pagos, y se instala con npx -y @sutempo/mcp. 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.

<script src="https://sutempo.com/widget.js"
  data-key="pk_…" data-mode="modal"></script>
<button data-platform-widget-open>Reservar</button>

SDK JavaScript y flujos de reserva a medida

Instala @sutempo/sdk con npm: ofrece un método por operación de OpenAPI y se regenera con el contrato. Utiliza @sutempo/booking-flow para crear tu propia interfaz, sin HTML ni CSS impuestos.

npm i @sutempo/sdk

Paga por gestionar negocios, no por llamar a la API.

Tu cuenta de desarrollador cuenta los negocios activos al mismo tiempo. Archivar un negocio libera su plaza. Todos los planes incluyen el entorno de pruebas, la consola, las claves y los webhooks.

En un negocio real, el acceso a la API requiere su plan Pro y la autorización revocable de su responsable. La suscripción Pro (29 € sin IVA al mes por local) la paga el negocio, no el desarrollador.

Crear una cuenta de desarrollador · Consultar el plan Agencia · Precios para negocios

Seguridad y fiabilidad

• Las claves tienen permisos explícitos y negocios asignados, se almacenan mediante hash y solo se muestran una vez.
• Los webhooks salientes se firman con HMAC-SHA256 sobre la marca temporal y el cuerpo; los destinos deben usar HTTPS.
• Las cuotas se aplican por clave, por negocio y globalmente. Al superar un límite se devuelve 429 con Retry-After.
• La aplicación se ejecuta en Vercel y la base de datos en Neon, en la región de Fráncfort.

Seguridad y notificación de vulnerabilidades · Historial de cambios