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.