Developer

API, MCP, widget de reservas y claves para desarrolladores.

Resumen rápido

—

Usa claves ctk_... como Authorization: Bearer. La API queda limitada al negocio asociado a la clave.

Claves de API

Crea claves para MCP, automatizaciones propias o integraciones server-to-server.

Cargando...

Autenticación

Para backends externos usa una clave API en la cabecera HTTP. Para herramientas de IA compatibles con MCP también puedes usar OAuth desde el flujo de conexión.

curl -H "Authorization: Bearer ctk_TU_CLAVE" \
  https://citeri.es/api/mcp

REST API

El contrato completo está en /api/openapi.json. Endpoints principales:

GET
/api/appointments
Lista citas por negocio, fecha, estado o empleado.
POST
/api/appointments
Crea una cita con cliente, servicio, empleado e inicio.
PATCH
/api/appointments/{id}/status
Actualiza estado y, opcionalmente, notifica al cliente.
GET
/api/clients
Busca clientes por nombre, email o teléfono.
GET
/api/services
Lista servicios disponibles.
fetch("https://citeri.es/api/appointments?org_id=TU_ORG_ID", {
  headers: { Authorization: "Bearer ctk_TU_CLAVE" }
})

MCP para IA

—

El servidor MCP permite a asistentes autorizados consultar agenda, crear citas, gestionar clientes, servicios, cupones, facturas y estadísticas del negocio.

Endpoint: https://citeri.es/api/mcp
Discovery: https://citeri.es/api/mcp/.well-known/oauth-protected-resource
OAuth: Authorization Code + PKCE S256

Reservas públicas y widget

Para mostrar reservas en una web externa puedes usar el enlace público o el widget embebible.

—
Abrir 

        


        

          
Calendario ICS

          
Feed privado para Google Calendar, Apple Calendar u Outlook.

          

            
—

            
            Google Calendar