Saltar al contenido principal

Bookings

La API de Bookings ofrece a las integraciones acceso de lectura a las reservas y a los tipos de reserva (tipos de evento) de tu workspace. Se complementa con webhooks salientes que notifican a tus sistemas cada vez que una reserva cambia — creada, confirmada, cancelada, reprogramada, rechazada, reasignada o marcada como inasistencia (no-show).

Los endpoints de lectura están limitados al workspace de tu token: nunca puedes leer las reservas de otro workspace.

Inicio rápido​

# List bookings (newest first, keyset pagination)
curl -X GET "https://api.copera.ai/public/v1/bookings?status=CONFIRMED&limit=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get a single booking by its public uid
curl -X GET https://api.copera.ai/public/v1/bookings/BOOKING_UID \
  -H "Authorization: Bearer YOUR_API_KEY"

# List booking types (event types)
curl -X GET https://api.copera.ai/public/v1/booking-types \
  -H "Authorization: Bearer YOUR_API_KEY"

Disponible en​

Public APICLIMCPCopera AI
✅ Solo lectura———

Los endpoints de lectura están disponibles a través de la Public API. Bookings aún no está expuesto a través del CLI, el servidor MCP alojado ni el asistente Copera AI integrado en la app.

información

Los endpoints de Bookings aún no están en la referencia de la API en vivo — producción todavía no ha publicado su superficie OpenAPI. Mientras tanto, esta guía es la referencia; usa las estructuras de solicitud que aparecen a continuación con la Public API.

Superficie de solo lectura​

La Public API expone tres endpoints GET. No hay endpoints de creación, cancelación, confirmación, rechazo ni reprogramación — las reservas se gestionan dentro de la app de Copera y se leen a través de la API.

Listar reservas​

GET /public/v1/bookings devuelve las reservas del workspace, las más recientes primero, con paginación por keyset. Parámetros de consulta (todos opcionales):

  • status — PENDING, CONFIRMED, DECLINED, CANCELLED o COMPLETED.
  • bookingTypeId — restringe a un único tipo de reserva.
  • from / to — fechas y horas ISO-8601; filtra por la hora de inicio de la reserva.
  • limit — 1–100 (por defecto 25).
  • cursor — el nextCursor de una respuesta anterior.
curl -X GET "https://api.copera.ai/public/v1/bookings?status=CONFIRMED&limit=25" \
  -H "Authorization: Bearer YOUR_TOKEN"

La respuesta está paginada por keyset:

{ "bookings": [ /* … */ ], "nextCursor": "…", "hasMore": true }

Obtener una reserva​

GET /public/v1/bookings/{uid} devuelve una sola reserva por su uid público.

Listar tipos de reserva​

GET /public/v1/booking-types devuelve los tipos de reserva (tipos de evento) del workspace. No toma parámetros y devuelve todos, incluidos los ocultos e inactivos (cada uno lleva las banderas hidden y active para que puedas filtrar del lado del cliente).

Qué contiene una reserva​

Un objeto de reserva incluye su uid, status, el bookingTypeId y bookingTypeTitle, start / end / durationMinutes, timezoneAtBooking, los hosts (cada uno { userId, role }), el booker (name, email, phone opcional, timezone, locale), guests, las answers del formulario y la location. Como se trata de los datos de tu propio workspace, se incluyen los datos de contacto del booker; los identificadores internos como el token de gestión y la clave de idempotencia nunca se exponen.

Un tipo de reserva incluye su _id, title, slug y description opcionales, kind, durationMinutes, color opcional, las banderas hidden y active, y marcas de tiempo.

Webhooks​

Además de leer reservas, puedes recibir webhooks salientes que notifican a tus sistemas cada vez que una reserva cambia. Consulta Webhooks de reservas para conocer la lista de eventos, el payload firmado, los encabezados, la verificación de firma y el contrato de entrega/reintentos.

Autenticación y alcance​

Los endpoints de Bookings aceptan un Personal Access Token completo (cp_pat_) o una clave de API de integración (cp_key_) con el alcance access_bookings. Un token que carezca del alcance recibe un 403. Consulta Autenticación.

Referencia​

  • Webhooks de reservas — la lista de eventos, el payload firmado, los encabezados, la verificación de firma y el contrato de entrega/reintentos.
  • Autenticación y Paginación — alcances de token y el modelo de cursor por keyset que usa list bookings.