API para desarrolladores

Empiece con lo simple e integre después a fondo.

Lance en la página alojada para ir rápido, integre el widget para respetar el diseño de su sitio, o cree un flujo totalmente a medida sobre la API REST pública, con claves de alcance limitado, reserva idempotente y una especificación OpenAPI 3.1 publicada.

Empezar Ver el widget de reservas

Ideal para: desarrolladores que crean una experiencia de reserva a medida (su propia interfaz, su propia lógica) sobre el mismo motor que hay detrás de la página alojada y el widget.

Elija su integración

3 formas

Página de reservas alojada, sin código

Widget integrado, unas pocas líneas

API REST pública✓

Qué resuelve

Tres formas de construir, un solo motor de reservas.

No todos los negocios necesitan el mismo nivel de control, y no debería tener que elegir de entrada. La página alojada le pone en marcha rápido, el widget mete la reserva dentro del diseño de su sitio, y la API está ahí cuando necesita una experiencia totalmente a medida.

Los tres funcionan sobre el mismo motor, así que el bloqueo de plazas, los pagos, las exenciones y las confirmaciones se comportan igual elija lo que elija. Empiece con lo simple y pase a la API cuando su producto necesite lógica a medida, sin migración por el camino.

# Crear una reserva POST /v1/bookings Authorization: Bearer sk_... { "event_id": "evt_8KQ2", "seats": 2 } -> 201 Created { "id": "bkg_5X9", "status": "confirmed" }

Endpoints públicos

La API REST sobre la que se construye su proceso de reserva.

/v1/events. Liste las sesiones reservables con sus datos y la disponibilidad de plazas en directo.
/v1/bookings. Cree reservas con una clave de idempotencia para que los reintentos nunca dupliquen la reserva.
/v1/giftcards. Consulte y aplique tarjetas regalo como parte de una reserva.
/v1/promocodes. Valide un código promocional antes del pago, con acceso público limitado en frecuencia.
/v1/customers. Trabaje con las fichas de cliente enlazadas por correo.
/v1/courses. Liste cursos de varias sesiones, obtenga presupuestos y reserve un curso completo en una sola llamada.
/v1/categories. Lea sus categorías de eventos para agrupar y filtrar lo que muestra.
/v1/tenant/config. Obtenga la configuración pública para renderizar correctamente su proceso de reserva.
/v1/referrals. Consulte un código de recomendación para que los clientes recomendados reciban el crédito correcto.
/v1/payments/paypal. Cree y capture pedidos de PayPal como parte de una reserva.
Especificación OpenAPI 3.1. Toda la API se entrega como una especificación OpenAPI 3.1 completa y descargable a partir de la cual puede generar clientes tipados, con una referencia interactiva en la aplicación y ejemplos de petición y respuesta listos para copiar.

Claves y seguridad

Pensado para producción desde la primera petición.

Claves públicas y secretas. Incruste claves públicas pk_ en el navegador y mantenga las claves secretas sk_ en el servidor para acceso completo.
Alcances en las claves públicas. Conceda a una clave de navegador solo el acceso que necesita, como consultar eventos o comprobar saldos de tarjetas regalo, y nada más.
Comprobación de origen para claves públicas. Añada orígenes permitidos a una clave pública y las peticiones que lleven un Origin de navegador deberán coincidir, de modo que una clave no pueda reutilizarse desde otro sitio.
Caducidad, revocación y edición. Dé a una clave una fecha de caducidad opcional, revóquela al instante o actualice su nombre, alcances y orígenes según cambie su integración.
Secretos guardados con hash. La clave en bruto se muestra una sola vez al crearla; solo se guarda un hash, así que una base de datos filtrada nunca expone una clave utilizable.
Límites de frecuencia. Las peticiones tienen límite de frecuencia para mantener la API estable bajo carga y frente a abusos.
Claves de idempotencia en la reserva. Reintentos seguros: una conexión caída nunca se convierte en una reserva duplicada.
El mismo motor por debajo. El bloqueo de plazas, los pagos, las exenciones y las confirmaciones coinciden exactamente con la página alojada y el widget.

Cómo funciona

De la primera llamada al flujo a medida en producción.

Cree sus claves

Genere claves públicas y secretas, defina alcances en las claves públicas y añada orígenes permitidos para que se comprueben las peticiones del navegador.

Lea el calendario

Llame a /v1/events para listar las sesiones reservables y la disponibilidad de plazas, y valide los códigos promocionales antes del pago.

Cree reservas

Envíe una petición a /v1/bookings con una clave de idempotencia. Las plazas se bloquean durante el pago y el cobro se captura.

Publique su experiencia a medida

Cree la interfaz que quiera sobre la API, apoyándose en los endpoints documentados y los ejemplos del SDK para avanzar rápido.