API REST
Integre la reserva en sus propios sistemas
Sus usuarios deben poder reservar sin salir de su plataforma: con su marca y con sus identificadores. La API de timum cubre todo el ciclo de vida, desde la estructura organizativa hasta la reserva del consumidor. Son exactamente los endpoints con los que el widget BookingJs reserva a diario en producción: por la infraestructura de timum ya se han coordinado más de 2.000.000 de participantes.
Acceso a la API bajo petición – incluido en los planes anuales. Basta una llamada.
Como funciona
Solicitar la clave de API
Basta una llamada – el acceso a la API forma parte de los planes anuales. Recibirá la clave para la cabecera X-TIMUM-CLIENT-ID. Está vinculada a su crmId, que todas las rutas de la Partner API llevan como parámetro.
Crear estructura y oferta
Initial Setup (users, accounts, providers, staff) y después Configure Offerings (propiedades, tipos de cita, perfiles de contacto).
Dejar reservar
Booking Flow: llamar a upcoming_bookables → reserve_appointment (bloqueo de 3 minutos) → create_appointment_with_consumer.
Sus beneficios
Totalmente programático: users, accounts, providers, propiedades, tipos de cita, timeslots y reservas vía REST, con autenticación por la cabecera X-TIMUM-CLIENT-ID.
Sus identificadores siguen mandando: el formato de referencia {uniqueId}@{platformName} le ahorra el mapeo de claves ajenas; referencia las entidades con los identificadores de su propio sistema.
Open Booking API sin clave de API para su frontend de consumidor: los mismos endpoints que en el widget, incluida la reserva de 3 minutos.
JSON, CORS y códigos de estado precisos: una cita ya adjudicada responde con 412 Precondition Failed en lugar de una race condition, con alojamiento en Fráncfort.
¿Quien necesita esta funcion?
Descubra como esta funcion ayuda a diferentes usuarios
Reserva nativa en la propia web
Su agencia integra la selección de horarios directamente en su web, mediante los endpoints de Open Booking, sin el diseño del widget y sin clave de API.
La reserva de citas como función del producto
Los proveedores de CRM o de portales integran la coordinación de citas bajo su propia marca. timum permanece invisible para el cliente final; los usuarios no cuestan nada, se paga lo que es reservable.
El portal de interesados del promotor
El portal del proyecto crea una propiedad reservable por unidad y reserva visitas vía API: los identificadores de unidad de su propio sistema siguen siendo la referencia.
Funciones relacionadas
Integre la reserva de citas en su producto
30 dias gratis. No se requiere tarjeta de credito.
