Streaming

Ladda ner schema

Observera: Endast slutpunkten Start streaming kan användas för att starta streaming från en Kaleo Connect-enhet. Denna slutpunkt kan inte användas för att starta streaming från en webbläsare. Alla andra streaming-slutpunkter styr både webbläsare och Kaleo Connect-enheter.

Hämta streamingstatus

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

Läs aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

Hämta streamingstatus › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Hämta streamingstatus › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

Starta streaming

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/start

Bearer (API key)

Starta streaming på en Kaleo Connect-enhet med sparade inställningar. Den valfria kroppen kan välja en deviceId och åsidosätta inställningar för denna session. Utan deviceId väljer Kaleo standardljudkällan konfigurerad på sidan Kaleo Connect (under Integrationer) i din kontrollpanel om flera ljudenheter finns tillgängliga, eller den enda tillgängliga ljudkällan om endast en finns.

Starta streaming › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Starta streaming › Förfrågningskropp valfritt

StartStreaming

deviceId

string

Valfritt enhets-ID för ljudkälla från GET /devices. Åsidosätter kyrkans standard för denna session. Om utelämnad används sparad standardljudkälla eller den enda ljudkälla som är ihopparad; flera enheter utan standard kräver val. Den valda enheten måste fortfarande vara redo.

object

Inställningar endast för denna session. Uteslutna fält använder sparade standardvärden.

Starta streaming › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

POST/v1/church/{churchId}/streaming/start

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/start \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{}'

Exempel på förfrågningskropp

{}

json

application/json

Exempel på svar

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Stoppa streaming

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/stop

Bearer (API key)

Stoppa den aktuella streaming-sessionen. Ingen begäran behövs i kroppen.

Stoppa streaming › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Stoppa streaming › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

Byt översättarröst

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/voice

Bearer (API key)

Byt översättarröst medan inaktiv eller under streaming.

Byt översättarröst › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Byt översättarröst › Förfrågningskropp

ChangeVoice

voice

string · enum · obligatorisk

Översättarröst. Kan ändras medan inaktiv eller under streaming.

Enum-värden:

male

female

Byt översättarröst › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

PATCH/v1/church/{churchId}/streaming/voice

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

Exempel på förfrågningskropp

{
  "voice": "female"
}

json

application/json

Exempel på svar

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "female",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Ändra synlighet

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/visibility

Bearer (API key)

Visa eller dölj undertexter medan inaktiv eller under streaming. Att dölja undertexter stoppar inte sessionen.

Ändra synlighet › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Ändra synlighet › Förfrågningskropp

ChangeVisibility

visible

boolean · obligatorisk

true visar undertexter; false döljer dem medan streaming fortsätter.

Ändra synlighet › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

PATCH/v1/church/{churchId}/streaming/visibility

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/visibility \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "visible": false
}'

Exempel på förfrågningskropp

{
  "visible": false
}

json

application/json

Exempel på svar

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": false,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Rensa undertexter

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/captions/clear

Bearer (API key)

Rensa den aktuella undertextflödet. Ingen begäran behövs i kroppen.

Rensa undertexter › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Rensa undertexter › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

POST/v1/church/{churchId}/streaming/captions/clear

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/captions/clear \
  --request POST \
  --header 'Authorization: Bearer <token>'

Exempel på svar

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Ändra automatisk stopp-tid

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline

Bearer (API key)

Ställ in automatisk stopptid för en aktiv session. Returnerar uppdaterad streamingstatus.

Ändra automatisk stopp-tid › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Ändra automatisk stopp-tid › Förfrågningskropp

ChangeDeadline

deadlineAt

string · date-time · obligatorisk

Framtida automatisk stopptid med Z eller tidszonsförskjutning. Senast sex timmar efter startedAt.

Ändra automatisk stopp-tid › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

PATCH/v1/church/{churchId}/streaming/deadline

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deadlineAt": "2026-10-08T16:00:00Z"
}'

Exempel på förfrågningskropp

{
  "deadlineAt": "2026-10-08T16:00:00Z"
}

json

application/json

Exempel på svar

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Justera automatisk stopptid

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline/adjust

Bearer (API key)

Lägg till eller dra ifrån automatisk stopptid. När inaktiv ändrar du varaktigheten för nästa manuella start. Under streaming ändrar du aktuell deadline. Varje förfrågan tillämpar en separat justering.

Justera automatisk stopptid › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Justera automatisk stopptid › Förfrågningskropp

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · obligatorisk

Sekunder att lägga till på inaktiv varaktighet eller aktuell deadline; negativa värden drar ifrån. Kan inte vara 0. Inaktiv varaktighet: 60–21600 sekunder. Live-deadline: framtida, inom sex timmar från startedAt.

Justera automatisk stopptid › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

POST/v1/church/{churchId}/streaming/deadline/adjust

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline/adjust \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deltaSeconds": 120
}'

Exempel på förfrågningskropp

{
  "deltaSeconds": 120
}

json

application/json

Exempel på svar

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Enheter Sessioner

Kaleo API

Streaming

Ladda ner schema

Hämta streamingstatus

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

Läs aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

Hämta streamingstatus › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Hämta streamingstatus › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

Starta streaming

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/start

Bearer (API key)

Starta streaming › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Starta streaming › Förfrågningskropp valfritt

StartStreaming

deviceId

string

object

Inställningar endast för denna session. Uteslutna fält använder sparade standardvärden.

Starta streaming › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

POST/v1/church/{churchId}/streaming/start

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/start \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{}'

Exempel på förfrågningskropp

{}

json

application/json

Exempel på svar

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Stoppa streaming

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/stop

Bearer (API key)

Stoppa den aktuella streaming-sessionen. Ingen begäran behövs i kroppen.

Stoppa streaming › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Stoppa streaming › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

Byt översättarröst

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/voice

Bearer (API key)

Byt översättarröst medan inaktiv eller under streaming.

Byt översättarröst › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Byt översättarröst › Förfrågningskropp

ChangeVoice

voice

string · enum · obligatorisk

Översättarröst. Kan ändras medan inaktiv eller under streaming.

Enum-värden:

male

female

Byt översättarröst › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

PATCH/v1/church/{churchId}/streaming/voice

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

Exempel på förfrågningskropp

{
  "voice": "female"
}

json

application/json

Exempel på svar

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "female",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Ändra synlighet

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/visibility

Bearer (API key)

Visa eller dölj undertexter medan inaktiv eller under streaming. Att dölja undertexter stoppar inte sessionen.

Ändra synlighet › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Ändra synlighet › Förfrågningskropp

ChangeVisibility

visible

boolean · obligatorisk

true visar undertexter; false döljer dem medan streaming fortsätter.

Ändra synlighet › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

PATCH/v1/church/{churchId}/streaming/visibility

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/visibility \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "visible": false
}'

Exempel på förfrågningskropp

{
  "visible": false
}

json

application/json

Exempel på svar

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": false,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Rensa undertexter

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/captions/clear

Bearer (API key)

Rensa den aktuella undertextflödet. Ingen begäran behövs i kroppen.

Rensa undertexter › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Rensa undertexter › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

POST/v1/church/{churchId}/streaming/captions/clear

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/captions/clear \
  --request POST \
  --header 'Authorization: Bearer <token>'

Exempel på svar

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Ändra automatisk stopp-tid

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline

Bearer (API key)

Ställ in automatisk stopptid för en aktiv session. Returnerar uppdaterad streamingstatus.

Ändra automatisk stopp-tid › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Ändra automatisk stopp-tid › Förfrågningskropp

ChangeDeadline

deadlineAt

string · date-time · obligatorisk

Framtida automatisk stopptid med Z eller tidszonsförskjutning. Senast sex timmar efter startedAt.

Ändra automatisk stopp-tid › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

PATCH/v1/church/{churchId}/streaming/deadline

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deadlineAt": "2026-10-08T16:00:00Z"
}'

Exempel på förfrågningskropp

{
  "deadlineAt": "2026-10-08T16:00:00Z"
}

json

application/json

Exempel på svar

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Justera automatisk stopptid

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline/adjust

Bearer (API key)

Justera automatisk stopptid › Sökvägsparametrar

churchId

string · obligatorisk

Ditt kyrko-ID. Kopiera det från sidan API (under Integrationer) i din kontrollpanel.

Justera automatisk stopptid › Förfrågningskropp

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · obligatorisk

Justera automatisk stopptid › Svar

Lyckades

Aktuell session och delade kyrkoinställningar. Alla fält är närvarande, även när inaktiv.

StreamingStatus

streaming

boolean · obligatorisk

true under en aktiv session, inklusive uppstart, återanslutningar och avstängning. Bekräftar inte att ljud anländer.

sessionId

string | null · obligatorisk

Aktuellt sessions-ID; null när inaktiv.

startedAt

string | null · date-time · obligatorisk

Aktuell sessions starttid; null när inaktiv.

deadlineAt

string | null · date-time · obligatorisk

Automatisk stopptid; null när inaktiv eller om ingen deadline är inspelad.

speakerLanguage

string | null · obligatorisk

Aktuell talarspråkkod; null när inaktiv.

targetLanguages

string[] · obligatorisk

Aktuella översättningsspråkkoder; tomt när inaktiv.

voice

string · enum · obligatorisk

Översättarröst, även när inaktiv.

Enum-värden:

male

female

visible

boolean · obligatorisk

true visar undertexter; false döljer dem. Gäller även när inaktiv.

publisher

object | null · obligatorisk

Kaleo Connect-enhet eller webbläsare som skickar ljud; null när inaktiv.

phase

string · enum · obligatorisk

Sessionsfas; inaktiv betyder att ingen session är aktiv.

Enum-värden:

idle

starting

streaming

reconnecting

ending

object · obligatorisk

Kyrkans standardinställningar för nästa manuella start. Aktiva sessionsändringar ändrar inte dessa värden.

POST/v1/church/{churchId}/streaming/deadline/adjust

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline/adjust \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deltaSeconds": 120
}'

Exempel på förfrågningskropp

{
  "deltaSeconds": 120
}

json

application/json

Exempel på svar

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Enheter Sessioner