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.- El userID se puede consultar en la sección profile/developers de la aplicación.
<your-api-key>
: Es la clave de API del desarrollador.- La api key se puede consultar en la sección profile/developers de la aplicación.
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.