Saltar al contenido principal

Servicios

El event-type es el concepto fundamental de TimeTime. Un event-type sirve para representar un servicio que puede ser reservado. Por ejemplo, una peluquería puede tener dos tipos de eventos: "Corte de pelo" y "Lavar y peinar".

Cada event-type tendrá sus reglas de disponibilidad particulares, por ejemplo la duración de "corte de pelo" será de 20m mientras que lavar y peinar podría ser de 40m.

Un event-type se puede crear de forma manual desde la aplicación o se puede crear haciendo una petición HTTP a nuestra API pasándole todos los parámetros de configuración deseados. Una descripción detallada de todos los campos y opciones se puede leer en la especificación de nuestra API.

El siguiente fragmento de código muestra los campos impresindibles para crear un servicio desde nuestra API:

fetch("https://api.timetime.in/v1/event-types/<event-type-uuid>", {
method: "PUT",
headers: {
// Es importante especificar que nos comunicamos por JSON
"Content-Type": "application/json",
// Añadimos la clave de accesso a la api obtenida previamente
Authorization: "Bearer: <your-api-key>",
},
body: JSON.stringify({
// La duración de los eventos expresada an formato ISO
"duration": "PT1H",
// El nombre del servicio
"name": "Corte de pelo",
// La URL con la que se identificará el evento
"slug": "corte-de-pelo",
// La frecuencia con la que se puede agendar el servicio
"step": "PT1H",
// El identificador UUID del usuario que ofrece el servicio
"userId": "<user-uuid>",
// Campos requeridos que se pueden ignorar por ahora
"questions": [],
"thirdPartyCalendars": { "toSyncBookings": [], "toVerifyAvailability": [] },
"busyIntervals": [],
}),
});
  • <event-type-uuid>: Es un UUID cualquiera para identificar el event type.
    • Si ya existe se modificará el servicio existente y si no existe se creará uno nuevo. Puedes usar este para hacer pruebas:
  • <user-uuid>>: Es el identificador único universal UUID del usuario dueño del servicio.
  • <your-api-key>: Es la clave de API del desarrollador.

Cada vez que se crea un servicio, timetime genera una página de reservas donde los clientes pueden consultar la disponibilidad.

El enlace a la página de reservas tiene la estructura: https://app.timetime.in/book/<event-type-uuid>. La disponibilidad de un servicio también puede consultarse desde la API como veremos en la siguiente sección.