API para desarrolladores

Cree su propio proceso de pago sobre nuestra API de reservas.

La página alojada no necesita código, y el widget necesita unas pocas líneas. Cuando quiera pantallas de reserva propias, ahí está la API REST pública. Su desarrollador parte de una especificación OpenAPI 3.1 publicada, y las llamadas de reserva se pueden reintentar sin riesgo.

Empezar Ver el widget de reservas

Ideal para: desarrolladores que crean sus propias pantallas y lógica de reserva. Por debajo, es el mismo sistema de reservas que hace funcionar 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 aceptar reservas, un solo sistema detrás.

No tiene que decidirlo de entrada. La página alojada le pone en marcha hoy, y el widget lleva las reservas a su propia web. La API es para cuando quiera diseñar usted cada pantalla.

Las tres opciones cobran pagos, recogen exenciones y envían confirmaciones de la misma manera. Así puede empezar con la página alojada y usar la API más adelante sin migrar nada.

# Create a booking
POST /v1/bookings
Authorization: Bearer sk_...
Idempotency-Key: order_1042

{
  "event_id": "evt_01K5W3JQ8C9T2N4R7VXHFGMB6D",
  "seat_count": 2,
  "email": "[email protected]",
  "first_name": "Jane",
  "last_name": "Smith",
  "payment_source_id": "pm_..."
}

-> 201 Created
{
  "id": "bkg_01K5W4B2ZQ6M8P3T1YNC7RDXAE",
  "booking_number": "7Q4M2X",
  "status": "confirmed"
}

Qué cubre la API

Todo lo que una pantalla de reservas necesita consultar.

Eventos y disponibilidad. Lea su programación con el recuento de plazas en directo, para que su interfaz solo ofrezca lo que de verdad se puede reservar en este momento.
Reservas. Cree, consulte y cancele reservas. Envíe una clave de idempotencia y un reintento tras una conexión cortada no reservará dos veces. Busque una reserva por su número para mostrarla en su propia página de agradecimiento.
Pago. Valide un código promocional, consulte y aplique una tarjeta regalo, y gestione los pasos de pago de una reserva.
Cursos. Liste cursos de varias sesiones por categoría, obtenga un precio y reserve el curso completo en una sola llamada. La compra se lee como un único registro con todas sus sesiones.
Clientes y recomendaciones. Trabaje con fichas de clientes identificadas por correo y consulte un enlace de recomendación para que el mérito vaya a la persona correcta.
Configuración. Obtenga los ajustes públicos y las categorías que sus pantallas de reserva necesitan para mostrarse.
Webhooks firmados. Su servidor se entera en el momento en que una reserva se crea, se modifica, se cancela o registra asistencia, se cobra o se reembolsa un pago, o se ofrece una plaza de la lista de espera. Cada envío va firmado para que pueda demostrar que viene de nosotros, y si uno falla, se reintenta.
Una especificación publicada. Descargue la especificación OpenAPI 3.1 completa y genere clientes tipados a partir de ella. La aplicación incluye una referencia interactiva con ejemplos de solicitud y respuesta que puede copiar.

Asistentes de IA

Pregunte a un asistente de IA sobre su estudio.

Conecte Claude o ChatGPT en un par de clics. Añada FullClass como conector, apruébelo una vez y pregunte «¿cómo de lleno está el sábado?» o «¿cuánto ingresamos en marzo?».
Solo lectura, siempre. Nada en este endpoint reserva, cancela, reembolsa ni envía correos. Responde preguntas y nada más.
Su programación y cómo de llena está. Pregunte qué viene, cómo se está llenando cada sesión y cuál es su tasa de ocupación clase a clase o mes a mes.
Lo que hay que promocionar. Obtenga las sesiones que no llegan a la mitad de su aforo, de la más vacía a la menos, mientras aún hay tiempo de hacer algo.
Reservas, dinero y asistencia. Número de reservas, con las cancelaciones y los pagos fallidos por separado. Ingresos de clases, tarjetas regalo y eventos privados. Y si quienes reservaron se presentaron de verdad.
Ningún dato de cliente sale. Recuentos de plazas, nunca nombres, correos ni teléfonos. Ni registros de pago ni enlaces de acceso a clases en línea.
Las cifras llegan con su letra pequeña. Cada respuesta indica la zona horaria con la que se calculó, y las cifras de dinero llevan sus propias notas contables, así que es más difícil citar un total fuera de contexto.
O apunte sus propias herramientas. Es un endpoint estándar de Model Context Protocol sobre HTTPS, así que otros clientes MCP también pueden conectarse, autenticándose con una clave secreta que ya tiene.

Claves y seguridad

Una clave pública que puede poner sin riesgo en un sitio web público.

Claves públicas y secretas. Ponga las claves públicas pk_ en el navegador. Guarde las claves secretas sk_ en su servidor para tener acceso completo.
Permisos en las claves públicas. Una clave de navegador solo obtiene lo que necesita, como consultar eventos o comprobar el saldo de una tarjeta regalo.
Comprobación de origen para las claves públicas. Indique los sitios a los que pertenece una clave pública. Toda solicitud con un Origin de navegador tiene que coincidir, así que nadie puede llevarse la clave y usarla en otro sitio.
Caducidad, revocación y edición. Fije una fecha de caducidad si la quiere, revoque una clave al instante o cambie su nombre, sus permisos y sus orígenes a medida que cambie su integración.
Secretos guardados como hash. Ve la clave completa una sola vez, al crearla. Solo guardamos un hash, así que una base de datos filtrada nunca expone una clave utilizable.
Límites de frecuencia. Las solicitudes tienen límite de frecuencia para mantener la API estable ante cargas elevadas o abusos.

Cómo funciona

De la primera clave a un proceso de pago en marcha.

Cree sus claves

Cree una clave pública y una clave secreta. Limite lo que puede hacer la clave pública y qué sitios pueden usarla.

Lea el calendario

Obtenga las sesiones que se pueden reservar y cuántas plazas le quedan a cada una. Valide códigos promocionales antes del pago.

Cree reservas

Envíe la reserva con una clave de idempotencia y el pago se captura. Si activa la retención de plazas en el pago, las plazas se retienen mientras el cliente paga.

Construya el resto a su manera

Diseñe las pantallas que quiera por encima, a partir de los endpoints documentados y los ejemplos del SDK.

No tiene que empezar por la API.

Empiece hoy mismo con la página de reservas alojada, coloque el widget de reservas en su propio sitio y pase a la API cuando quiera un proceso de pago propio. Sus reservas y sus datos se quedan donde están, así que no hay nada que migrar.

Siga explorando

Funciones relacionadas

Empiece hoy mismo

Construya las reservas a su manera.

Empiece hoy con la página alojada y pase a la API cuando su propio desarrollo esté listo.

Empezar Iniciar sesión

Prueba gratuita de 30 días · Cancele cuando quiera