Integración de API (avanzada)
Las citas reservables se pueden consultar y reservar directamente a través de los endpoints API abiertos de la Consumer Booking API. Dado que aquí solo hay disponibles citas reservables públicamente, no se requiere autenticación.
Para integraciones completas a través de la timum Partner API, póngase en contacto con nuestro servicio: +49 (0)30 41765984 o a través de www.timum.de.
Información básica – importante
El calendario del proveedor ("Provider") se indica mediante su UUID: Buscar UUID del proveedor
Los recursos reservables (asesores, inmuebles, objetos) se referencian mediante identificadores específicos de los sistemas CRM o mediante UUID de timum: Buscar o crear referencias
La reserva de citas a través de la API abierta de timum sigue una secuencia de solicitudes típica:
1. Filtrar tipos de cita (opcional)
Opcionalmente, puede consultar de antemano la lista de tipos de cita ofrecidos y filtrar las citas disponibles por tipo de cita, algo útil si desea definir franjas horarias específicas por tipo de cita: endpoint POST list active products
2. Consultar citas reservables
Consultar las citas reservables disponibles: endpoint GET upcoming bookables
3. Reservar la franja horaria seleccionada
En cuanto un cliente o una clienta haya preseleccionado una cita, resérvela primero durante 3 minutos para que nadie más pueda reservarla mientras se introducen los datos del cliente: endpoint POST reserve appointment
4. Reservar la cita con los datos del cliente
Una vez proporcionada toda la información necesaria, reserve la cita con los datos del cliente: POST create appointment with consumer
Más información
- Incrustar widget – la forma más sencilla, sin integración de API propia
- Documentación para desarrolladores