Skip to navigation

Programar sesiones de una clase

Escribe las sesiones de una clase con una regla semanal, como el formulario de Clases: “martes y jueves a las 5:45, del 6 de octubre al 15 de diciembre”. weekdays va de 0 (domingo) a 6 y time es HH:MM en la zona del negocio. Es todo o nada: si el instructor o el salón ya están ocupados a alguna de esas horas, no escribe ninguna (busy). Una hora fuera del horario del negocio, del instructor o del salón se salta y aparece en skipped_starts_at. Cada sesión tiene el cupo de la clase. Para apartar un lugar usa POST /bookings con class_session_id.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Request

This endpoint expects an object.
service_idstringRequired

La clase (un servicio kind: class).

staff_member_idstringRequired

Quién la da.

weekdayslist of integersRequired
timestringRequired
from_ondateRequired
until_ondateRequired
resource_idstringOptional

El salón o recurso que ocupa, si ocupa uno.

Response

Las sesiones escritas y las horas que se saltaron
sessionslist of objectsOptional
skipped_starts_atlist of datetimesOptional
Las horas que caen fuera del horario y no se escribieron.

Errors

400
Bad Request Error
422
Unprocessable Entity Error