일정

스키마 다운로드

Kaleo Connect 기기의 예약 스트리밍 이벤트입니다.

예약 이벤트 목록 조회

GET

https://babel.withkaleo.com

/v1/church/{churchId}/schedule

Bearer (API key)

예약 이벤트를 최신순으로 조회합니다.

예약 이벤트 목록 조회 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

예약 이벤트 목록 조회 › 쿼리 매개변수

page

integer · min: 1

페이지 번호, 1부터 시작합니다. 마지막 페이지를 초과하는 값은 마지막 페이지를 반환합니다.

기본값: 1

pageSize

integer · min: 1

페이지당 이벤트 수입니다. 100을 초과하면 100을 사용합니다.

기본값: 14

예약 이벤트 목록 조회 › 응답

성공

ScheduledEventPage

ScheduledEvent[] · 필수

total

integer · min: 0 · 필수

모든 페이지에서 조건에 맞는 예약 이벤트의 총수입니다.

page

integer · min: 1 · 필수

반환된 페이지; 요청한 페이지보다 낮을 수 있습니다.

pageSize

integer · min: 1 · max: 100 · 필수

예약 이벤트 조회

GET

https://babel.withkaleo.com

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

Bearer (API key)

예약 이벤트 하나를 조회합니다.

예약 이벤트 조회 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

eventId

string · 필수

GET /schedule에서 가져온 예약 이벤트 ID입니다.

예약 이벤트 조회 › 응답

성공

ScheduledEventDetails

ScheduledEvent · 필수

예약 이벤트 생성

POST

https://babel.withkaleo.com

/v1/church/{churchId}/schedule

Bearer (API key)

예약 이벤트를 생성합니다. 생략한 스트리밍 설정에는 교회의 저장된 기본값이 적용됩니다.

예약 이벤트 생성 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

예약 이벤트 생성 › 요청 본문

CreateScheduledEvent

name

string · minLength: 1 · maxLength: 120 · 필수

deviceId

string · 필수

GET /devices에서 가져온 Kaleo Connect 기기 ID입니다.

startsAt

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

시간대 오프셋이 없는 현지 시작 날짜와 시간입니다. timezone에 따라 해석됩니다.

timezone

string · 필수

America/Toronto와 같은 IANA 시간대입니다. 반복은 현지 시간을 따릅니다. 서머타임 전환으로 존재하지 않는 시간은 건너뛰고 중복되는 시간에는 한 번만 실행합니다.

repeat

string · enum

반복 주기입니다. 이벤트 생성 시 기본값은 "once"입니다.

열거형 값:

once

daily

weekly

기본값: once

weekdays

string[] · maxItems: 7 · unique

매주 반복할 요일입니다. repeat가 "weekly"이면 필수이며, 그 외에는 비워 둡니다.

열거형 값:

기본값: []

speakerLanguage

string

GET /languages/speaker에서 가져온 코드입니다. 다국어 모드에는 "mul"를 사용하세요.

targetLanguages

string[]

GET /languages/target에서 가져온 코드입니다. 플랜 한도 내에서 지원되는 모든 대상에 ["ALL"]를 사용하세요.

duration

integer · min: 60 · max: 21600

자동 중지까지의 시간(초)입니다.

ProPresenterSelection

이 세션에 사용할 ProPresenter 소스를 선택합니다. 연결은 Connect에서 구성하세요.

예약 이벤트 생성 › 응답

성공

ScheduledEventDetails

ScheduledEvent · 필수

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"
  }
}'

요청 본문 예시

{
  "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

응답 예시

{
  "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

예약 이벤트 수정

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

예약 이벤트를 수정합니다. 생략한 필드는 현재 값을 유지합니다. 변경 사항은 이후 시작에 적용됩니다.

예약 이벤트 수정 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

eventId

string · 필수

GET /schedule에서 가져온 예약 이벤트 ID입니다.

예약 이벤트 수정 › 요청 본문

UpdateScheduledEvent

name

string · minLength: 1 · maxLength: 120

deviceId

string

GET /devices에서 가져온 Kaleo Connect 기기 ID입니다.

startsAt

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

시간대 오프셋이 없는 현지 시작 날짜와 시간입니다. timezone에 따라 해석됩니다.

timezone

string

repeat

string · enum

반복 주기입니다. 이벤트 생성 시 기본값은 "once"입니다.

열거형 값:

once

daily

weekly

weekdays

string[] · maxItems: 7 · unique

매주 반복할 요일입니다. repeat가 "weekly"이면 필수이며, 그 외에는 비워 둡니다.

열거형 값:

speakerLanguage

string

GET /languages/speaker에서 가져온 코드입니다. 다국어 모드에는 "mul"를 사용하세요.

targetLanguages

string[]

GET /languages/target에서 가져온 코드입니다. 플랜 한도 내에서 지원되는 모든 대상에 ["ALL"]를 사용하세요.

duration

integer · min: 60 · max: 21600

자동 중지까지의 시간(초)입니다.

ProPresenterSelection

이 세션에 사용할 ProPresenter 소스를 선택합니다. 연결은 Connect에서 구성하세요.

예약 이벤트 수정 › 응답

성공

ScheduledEventDetails

ScheduledEvent · 필수

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
}'

요청 본문 예시

{
  "duration": 5400
}

json

application/json

응답 예시

{
  "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

예약 이벤트 삭제

DELETE

https://babel.withkaleo.com

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

Bearer (API key)

예약 이벤트를 삭제하고 이후 시작을 취소합니다. 이미 진행 중인 스트리밍은 계속됩니다.

예약 이벤트 삭제 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

eventId

string · 필수

GET /schedule에서 가져온 예약 이벤트 ID입니다.

예약 이벤트 삭제 › 응답

성공

eventId

string · 필수

removed

boolean · enum · 필수

열거형 값:

세션

예약 이벤트 목록 조회

GET

https://babel.withkaleo.com

/v1/church/{churchId}/schedule

Bearer (API key)

예약 이벤트를 최신순으로 조회합니다.

예약 이벤트 목록 조회 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

예약 이벤트 목록 조회 › 쿼리 매개변수

page

integer · min: 1

페이지 번호, 1부터 시작합니다. 마지막 페이지를 초과하는 값은 마지막 페이지를 반환합니다.

기본값: 1

pageSize

integer · min: 1

페이지당 이벤트 수입니다. 100을 초과하면 100을 사용합니다.

기본값: 14

예약 이벤트 목록 조회 › 응답

성공

ScheduledEventPage

ScheduledEvent[] · 필수

total

integer · min: 0 · 필수

모든 페이지에서 조건에 맞는 예약 이벤트의 총수입니다.

page

integer · min: 1 · 필수

반환된 페이지; 요청한 페이지보다 낮을 수 있습니다.

pageSize

integer · min: 1 · max: 100 · 필수

예약 이벤트 조회

GET

https://babel.withkaleo.com

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

Bearer (API key)

예약 이벤트 하나를 조회합니다.

예약 이벤트 조회 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

eventId

string · 필수

GET /schedule에서 가져온 예약 이벤트 ID입니다.

예약 이벤트 조회 › 응답

성공

ScheduledEventDetails

ScheduledEvent · 필수

예약 이벤트 생성

POST

https://babel.withkaleo.com

/v1/church/{churchId}/schedule

Bearer (API key)

예약 이벤트를 생성합니다. 생략한 스트리밍 설정에는 교회의 저장된 기본값이 적용됩니다.

예약 이벤트 생성 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

예약 이벤트 생성 › 요청 본문

CreateScheduledEvent

name

string · minLength: 1 · maxLength: 120 · 필수

deviceId

string · 필수

GET /devices에서 가져온 Kaleo Connect 기기 ID입니다.

startsAt

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

시간대 오프셋이 없는 현지 시작 날짜와 시간입니다. timezone에 따라 해석됩니다.

timezone

string · 필수

repeat

string · enum

반복 주기입니다. 이벤트 생성 시 기본값은 "once"입니다.

열거형 값:

once

daily

weekly

기본값: once

weekdays

string[] · maxItems: 7 · unique

매주 반복할 요일입니다. repeat가 "weekly"이면 필수이며, 그 외에는 비워 둡니다.

열거형 값:

기본값: []

speakerLanguage

string

GET /languages/speaker에서 가져온 코드입니다. 다국어 모드에는 "mul"를 사용하세요.

targetLanguages

string[]

GET /languages/target에서 가져온 코드입니다. 플랜 한도 내에서 지원되는 모든 대상에 ["ALL"]를 사용하세요.

duration

integer · min: 60 · max: 21600

자동 중지까지의 시간(초)입니다.

ProPresenterSelection

이 세션에 사용할 ProPresenter 소스를 선택합니다. 연결은 Connect에서 구성하세요.

예약 이벤트 생성 › 응답

성공

ScheduledEventDetails

ScheduledEvent · 필수

예약 이벤트 수정

PATCH

https://babel.withkaleo.com

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

Bearer (API key)

예약 이벤트를 수정합니다. 생략한 필드는 현재 값을 유지합니다. 변경 사항은 이후 시작에 적용됩니다.

예약 이벤트 수정 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

eventId

string · 필수

GET /schedule에서 가져온 예약 이벤트 ID입니다.

예약 이벤트 수정 › 요청 본문

UpdateScheduledEvent

name

string · minLength: 1 · maxLength: 120

deviceId

string

GET /devices에서 가져온 Kaleo Connect 기기 ID입니다.

startsAt

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

시간대 오프셋이 없는 현지 시작 날짜와 시간입니다. timezone에 따라 해석됩니다.

timezone

string

repeat

string · enum

반복 주기입니다. 이벤트 생성 시 기본값은 "once"입니다.

열거형 값:

once

daily

weekly

weekdays

string[] · maxItems: 7 · unique

매주 반복할 요일입니다. repeat가 "weekly"이면 필수이며, 그 외에는 비워 둡니다.

열거형 값:

speakerLanguage

string

GET /languages/speaker에서 가져온 코드입니다. 다국어 모드에는 "mul"를 사용하세요.

targetLanguages

string[]

GET /languages/target에서 가져온 코드입니다. 플랜 한도 내에서 지원되는 모든 대상에 ["ALL"]를 사용하세요.

duration

integer · min: 60 · max: 21600

자동 중지까지의 시간(초)입니다.

ProPresenterSelection

이 세션에 사용할 ProPresenter 소스를 선택합니다. 연결은 Connect에서 구성하세요.

예약 이벤트 수정 › 응답

성공

ScheduledEventDetails

ScheduledEvent · 필수

예약 이벤트 삭제

DELETE

https://babel.withkaleo.com

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

Bearer (API key)

예약 이벤트를 삭제하고 이후 시작을 취소합니다. 이미 진행 중인 스트리밍은 계속됩니다.

예약 이벤트 삭제 › 경로 매개변수

churchId

string · 필수

교회 ID입니다. 대시보드의 통합(Integrations) 아래 API 페이지에서 복사하세요.

eventId

string · 필수

GET /schedule에서 가져온 예약 이벤트 ID입니다.

예약 이벤트 삭제 › 응답

성공

eventId

string · 필수

removed

boolean · enum · 필수

열거형 값: