Programación

Descargar esquema

Eventos de emisión programados para dispositivos Kaleo Connect.

Listar eventos programados

GET

https://babel.withkaleo.com

/v1/church/{churchId}/schedule

Bearer (API key)

Lista los eventos programados, del más reciente al más antiguo.

Listar eventos programados › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Listar eventos programados › Parámetros de consulta

page

integer · min: 1

Número de página, comenzando en 1. Valores superiores a la última página devuelven la última página.

Por defecto: 1

pageSize

integer · min: 1

Eventos por página. Los valores superiores a 100 utilizan 100.

Por defecto: 14

Listar eventos programados › Respuestas

Éxito

ScheduledEventPage

ScheduledEvent[] · requerido

total

integer · min: 0 · requerido

Total de eventos programados que coinciden, en todas las páginas.

page

integer · min: 1 · requerido

Página devuelta; puede ser menor que la solicitada.

pageSize

integer · min: 1 · max: 100 · requerido

Obtener evento programado

GET

https://babel.withkaleo.com

/v1/church/{churchId}/schedule/{eventId}

Bearer (API key)

Consulta un evento programado.

Obtener evento programado › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

eventId

string · requerido

ID del evento programado de GET /schedule.

Obtener evento programado › Respuestas

Éxito

ScheduledEventDetails

ScheduledEvent · requerido

Crear evento programado

POST

https://babel.withkaleo.com

/v1/church/{churchId}/schedule

Bearer (API key)

Crea un evento programado. Los ajustes de emisión omitidos utilizan los valores guardados de la iglesia.

Crear evento programado › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Crear evento programado › Cuerpo de la solicitud

CreateScheduledEvent

name

string · minLength: 1 · maxLength: 120 · requerido

deviceId

string · requerido

ID del dispositivo Kaleo Connect de GET /devices.

startsAt

string · pattern: ^\d{4}-\d{2}-\d{2}T\… · requerido

Fecha y hora de inicio en hora local, sin desplazamiento de zona horaria. Se interpreta en timezone.

timezone

string · requerido

Zona horaria IANA, como America/Toronto. Las repeticiones siguen la hora local; las horas inexistentes por el horario de verano se omiten y las horas repetidas se ejecutan una sola vez.

repeat

string · enum

Frecuencia de repetición. Al crear un evento, el valor predeterminado es "once".

Valores enumerados:

once

daily

weekly

Por defecto: once

weekdays

string[] · maxItems: 7 · unique

Días de las repeticiones semanales. Obligatorio cuando repeat es "weekly"; vacío en los demás casos.

Valores enumerados:

Por defecto: []

speakerLanguage

string

Código desde GET /languages/speaker. Usa "mul" para modo multilingüe.

targetLanguages

string[]

Códigos desde GET /languages/target. Usa ["ALL"] para todos los destinos soportados, dentro del límite de tu plan.

duration

integer · min: 60 · max: 21600

Tiempo hasta la detención automática, en segundos.

ProPresenterSelection

Elige la fuente ProPresenter para esta sesión. Configura su conexión en Connect.

Crear evento programado › Respuestas

Éxito

ScheduledEventDetails

ScheduledEvent · requerido

POST/v1/church/{churchId}/schedule

curl https://babel.withkaleo.com/v1/church/:churchId/schedule \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "Sunday service",
  "deviceId": "00000000-0000-4000-8000-000000000003",
  "startsAt": "2026-11-01T09:00:00",
  "timezone": "America/Toronto",
  "repeat": "weekly",
  "weekdays": [
    "SU"
  ],
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "duration": 3600,
  "proPresenter": {
    "mode": "default"
  }
}'

Ejemplo de cuerpo de solicitud

{
  "name": "Sunday service",
  "deviceId": "00000000-0000-4000-8000-000000000003",
  "startsAt": "2026-11-01T09:00:00",
  "timezone": "America/Toronto",
  "repeat": "weekly",
  "weekdays": [
    "SU"
  ],
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "duration": 3600,
  "proPresenter": {
    "mode": "default"
  }
}

json

application/json

Ejemplos de respuestas

{
  "event": {
    "eventId": "00000000-0000-4000-8000-000000000002",
    "name": "Sunday service",
    "deviceId": "00000000-0000-4000-8000-000000000003",
    "startsAt": "2026-11-01T09:00:00",
    "timezone": "America/Toronto",
    "repeat": "weekly",
    "weekdays": [
      "SU"
    ],
    "speakerLanguage": "en",
    "targetLanguages": [
      "fr-FR"
    ],
    "duration": 3600,
    "proPresenter": {
      "mode": "default"
    }
  }
}

json

application/json

Actualizar evento programado

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/schedule/{eventId}

Bearer (API key)

Modifica un evento programado. Los campos omitidos conservan sus valores actuales. Los cambios se aplican a los inicios futuros.

Actualizar evento programado › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

eventId

string · requerido

ID del evento programado de GET /schedule.

Actualizar evento programado › Cuerpo de la solicitud

UpdateScheduledEvent

name

string · minLength: 1 · maxLength: 120

deviceId

string

ID del dispositivo Kaleo Connect de GET /devices.

startsAt

string · pattern: ^\d{4}-\d{2}-\d{2}T\…

Fecha y hora de inicio en hora local, sin desplazamiento de zona horaria. Se interpreta en timezone.

timezone

string

Zona horaria IANA, como America/Toronto. Las repeticiones siguen la hora local; las horas inexistentes por el horario de verano se omiten y las horas repetidas se ejecutan una sola vez.

repeat

string · enum

Frecuencia de repetición. Al crear un evento, el valor predeterminado es "once".

Valores enumerados:

once

daily

weekly

weekdays

string[] · maxItems: 7 · unique

Días de las repeticiones semanales. Obligatorio cuando repeat es "weekly"; vacío en los demás casos.

Valores enumerados:

speakerLanguage

string

Código desde GET /languages/speaker. Usa "mul" para modo multilingüe.

targetLanguages

string[]

Códigos desde GET /languages/target. Usa ["ALL"] para todos los destinos soportados, dentro del límite de tu plan.

duration

integer · min: 60 · max: 21600

Tiempo hasta la detención automática, en segundos.

ProPresenterSelection

Elige la fuente ProPresenter para esta sesión. Configura su conexión en Connect.

Actualizar evento programado › Respuestas

Éxito

ScheduledEventDetails

ScheduledEvent · requerido

PATCH/v1/church/{churchId}/schedule/{eventId}

curl https://babel.withkaleo.com/v1/church/:churchId/schedule/:eventId \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "duration": 5400
}'

Ejemplo de cuerpo de solicitud

{
  "duration": 5400
}

json

application/json

Ejemplos de respuestas

{
  "event": {
    "eventId": "00000000-0000-4000-8000-000000000002",
    "name": "Sunday service",
    "deviceId": "00000000-0000-4000-8000-000000000003",
    "startsAt": "2026-11-01T09:00:00",
    "timezone": "America/Toronto",
    "repeat": "weekly",
    "weekdays": [
      "SU"
    ],
    "speakerLanguage": "en",
    "targetLanguages": [
      "fr-FR"
    ],
    "duration": 5400,
    "proPresenter": {
      "mode": "default"
    }
  }
}

json

application/json

Eliminar evento programado

DELETE

https://babel.withkaleo.com

/v1/church/{churchId}/schedule/{eventId}

Bearer (API key)

Elimina un evento programado y cancela sus inicios futuros. Una emisión que ya está en curso continúa.

Eliminar evento programado › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

eventId

string · requerido

ID del evento programado de GET /schedule.

Eliminar evento programado › Respuestas

Éxito

eventId

string · requerido

removed

boolean · enum · requerido

Valores enumerados:

Sesiones

Listar eventos programados

GET

https://babel.withkaleo.com

/v1/church/{churchId}/schedule

Bearer (API key)

Lista los eventos programados, del más reciente al más antiguo.

Listar eventos programados › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Listar eventos programados › Parámetros de consulta

page

integer · min: 1

Número de página, comenzando en 1. Valores superiores a la última página devuelven la última página.

Por defecto: 1

pageSize

integer · min: 1

Eventos por página. Los valores superiores a 100 utilizan 100.

Por defecto: 14

Listar eventos programados › Respuestas

Éxito

ScheduledEventPage

ScheduledEvent[] · requerido

total

integer · min: 0 · requerido

Total de eventos programados que coinciden, en todas las páginas.

page

integer · min: 1 · requerido

Página devuelta; puede ser menor que la solicitada.

pageSize

integer · min: 1 · max: 100 · requerido

Obtener evento programado

GET

https://babel.withkaleo.com

/v1/church/{churchId}/schedule/{eventId}

Bearer (API key)

Consulta un evento programado.

Obtener evento programado › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

eventId

string · requerido

ID del evento programado de GET /schedule.

Obtener evento programado › Respuestas

Éxito

ScheduledEventDetails

ScheduledEvent · requerido

Crear evento programado

POST

https://babel.withkaleo.com

/v1/church/{churchId}/schedule

Bearer (API key)

Crea un evento programado. Los ajustes de emisión omitidos utilizan los valores guardados de la iglesia.

Crear evento programado › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

Crear evento programado › Cuerpo de la solicitud

CreateScheduledEvent

name

string · minLength: 1 · maxLength: 120 · requerido

deviceId

string · requerido

ID del dispositivo Kaleo Connect de GET /devices.

startsAt

string · pattern: ^\d{4}-\d{2}-\d{2}T\… · requerido

Fecha y hora de inicio en hora local, sin desplazamiento de zona horaria. Se interpreta en timezone.

timezone

string · requerido

Zona horaria IANA, como America/Toronto. Las repeticiones siguen la hora local; las horas inexistentes por el horario de verano se omiten y las horas repetidas se ejecutan una sola vez.

repeat

string · enum

Frecuencia de repetición. Al crear un evento, el valor predeterminado es "once".

Valores enumerados:

once

daily

weekly

Por defecto: once

weekdays

string[] · maxItems: 7 · unique

Días de las repeticiones semanales. Obligatorio cuando repeat es "weekly"; vacío en los demás casos.

Valores enumerados:

Por defecto: []

speakerLanguage

string

Código desde GET /languages/speaker. Usa "mul" para modo multilingüe.

targetLanguages

string[]

Códigos desde GET /languages/target. Usa ["ALL"] para todos los destinos soportados, dentro del límite de tu plan.

duration

integer · min: 60 · max: 21600

Tiempo hasta la detención automática, en segundos.

ProPresenterSelection

Elige la fuente ProPresenter para esta sesión. Configura su conexión en Connect.

Crear evento programado › Respuestas

Éxito

ScheduledEventDetails

ScheduledEvent · requerido

Actualizar evento programado

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/schedule/{eventId}

Bearer (API key)

Modifica un evento programado. Los campos omitidos conservan sus valores actuales. Los cambios se aplican a los inicios futuros.

Actualizar evento programado › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

eventId

string · requerido

ID del evento programado de GET /schedule.

Actualizar evento programado › Cuerpo de la solicitud

UpdateScheduledEvent

name

string · minLength: 1 · maxLength: 120

deviceId

string

ID del dispositivo Kaleo Connect de GET /devices.

startsAt

string · pattern: ^\d{4}-\d{2}-\d{2}T\…

Fecha y hora de inicio en hora local, sin desplazamiento de zona horaria. Se interpreta en timezone.

timezone

string

Zona horaria IANA, como America/Toronto. Las repeticiones siguen la hora local; las horas inexistentes por el horario de verano se omiten y las horas repetidas se ejecutan una sola vez.

repeat

string · enum

Frecuencia de repetición. Al crear un evento, el valor predeterminado es "once".

Valores enumerados:

once

daily

weekly

weekdays

string[] · maxItems: 7 · unique

Días de las repeticiones semanales. Obligatorio cuando repeat es "weekly"; vacío en los demás casos.

Valores enumerados:

speakerLanguage

string

Código desde GET /languages/speaker. Usa "mul" para modo multilingüe.

targetLanguages

string[]

Códigos desde GET /languages/target. Usa ["ALL"] para todos los destinos soportados, dentro del límite de tu plan.

duration

integer · min: 60 · max: 21600

Tiempo hasta la detención automática, en segundos.

ProPresenterSelection

Elige la fuente ProPresenter para esta sesión. Configura su conexión en Connect.

Actualizar evento programado › Respuestas

Éxito

ScheduledEventDetails

ScheduledEvent · requerido

Eliminar evento programado

DELETE

https://babel.withkaleo.com

/v1/church/{churchId}/schedule/{eventId}

Bearer (API key)

Elimina un evento programado y cancela sus inicios futuros. Una emisión que ya está en curso continúa.

Eliminar evento programado › Parámetros de ruta

churchId

string · requerido

ID de tu iglesia. Cópialo desde la página API (en Integraciones) en tu panel de control.

eventId

string · requerido

ID del evento programado de GET /schedule.

Eliminar evento programado › Respuestas

Éxito

eventId

string · requerido

removed

boolean · enum · requerido

Valores enumerados: