Phiên

Tải xuống sơ đồ

Lịch sử phiên và phân tích người xem.

Liệt kê phiên

GET

https://babel.withkaleo.com

/v1/church/{churchId}/sessions

Bearer (API key)

Liệt kê các phiên, mới nhất trước, kèm phân tích người xem.

Liệt kê phiên › Tham số đường dẫn

churchId

string · bắt buộc

ID nhà thờ của bạn. Sao chép từ trang API (dưới mục Tích hợp) trong bảng điều khiển.

Liệt kê phiên › Tham số truy vấn

page

integer · min: 1

Số trang, bắt đầu từ 1. Giá trị vượt quá trang cuối trả về trang cuối.

Mặc định: 1

pageSize

integer · min: 1

Số phiên mỗi trang. Giá trị trên 100 sẽ dùng 100.

Mặc định: 14

startedAfter

string · date-time

Bao gồm các phiên bắt đầu từ hoặc sau thời gian này. Bao gồm Z hoặc lệch múi giờ.

startedBefore

string · date-time

Bao gồm các phiên bắt đầu từ hoặc trước thời gian này. Bao gồm Z hoặc lệch múi giờ. Phải bằng hoặc sau startedAfter.

Liệt kê phiên › Phản hồi

Thành công

HistoryPage

HistorySession[] · bắt buộc

total

integer · min: 0 · bắt buộc

Tổng số phiên phù hợp với bộ lọc, trên tất cả các trang.

page

integer · min: 1 · bắt buộc

Trang trả về; có thể thấp hơn trang yêu cầu.

pageSize

integer · min: 1 · max: 100 · bắt buộc

Số phiên tối đa mỗi trang, giới hạn 100.

GET/v1/church/{churchId}/sessions

curl https://babel.withkaleo.com/v1/church/:churchId/sessions \
  --header 'Authorization: Bearer <token>'

Ví dụ phản hồi

{
  "sessions": [
    {
      "sessionId": "00000000-0000-4000-8000-000000000001",
      "startedAt": "2026-10-04T14:00:00.000Z",
      "endedAt": "2026-10-04T15:00:00.000Z",
      "duration": 3600,
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "transcriptAvailable": true,
      "publicSharingEnabled": false,
      "analytics": {
        "sessionId": "00000000-0000-4000-8000-000000000001",
        "status": "finalized",
        "viewers": 12,
        "viewerLanguages": {
          "en": 8,
          "fr-FR": 6
        }
      }
    }
  ],
  "total": 1,
  "page": 1,
  "pageSize": 14
}

json

application/json

Lấy phiên

GET

https://babel.withkaleo.com

/v1/church/{churchId}/sessions/{sessionId}

Bearer (API key)

Đọc một phiên và phân tích người xem của nó.

Lấy phiên › Tham số đường dẫn

churchId

string · bắt buộc

ID nhà thờ của bạn. Sao chép từ trang API (dưới mục Tích hợp) trong bảng điều khiển.

sessionId

string · bắt buộc

ID phiên từ GET /sessions.

Lấy phiên › Phản hồi

Thành công

SessionDetails

HistorySession · bắt buộc

Phát trực tiếp

Liệt kê phiên

GET

https://babel.withkaleo.com

/v1/church/{churchId}/sessions

Bearer (API key)

Liệt kê các phiên, mới nhất trước, kèm phân tích người xem.

Liệt kê phiên › Tham số đường dẫn

churchId

string · bắt buộc

ID nhà thờ của bạn. Sao chép từ trang API (dưới mục Tích hợp) trong bảng điều khiển.

Liệt kê phiên › Tham số truy vấn

page

integer · min: 1

Số trang, bắt đầu từ 1. Giá trị vượt quá trang cuối trả về trang cuối.

Mặc định: 1

pageSize

integer · min: 1

Số phiên mỗi trang. Giá trị trên 100 sẽ dùng 100.

Mặc định: 14

startedAfter

string · date-time

Bao gồm các phiên bắt đầu từ hoặc sau thời gian này. Bao gồm Z hoặc lệch múi giờ.

startedBefore

string · date-time

Bao gồm các phiên bắt đầu từ hoặc trước thời gian này. Bao gồm Z hoặc lệch múi giờ. Phải bằng hoặc sau startedAfter.

Liệt kê phiên › Phản hồi

Thành công

HistoryPage

HistorySession[] · bắt buộc

total

integer · min: 0 · bắt buộc

Tổng số phiên phù hợp với bộ lọc, trên tất cả các trang.

page

integer · min: 1 · bắt buộc

Trang trả về; có thể thấp hơn trang yêu cầu.

pageSize

integer · min: 1 · max: 100 · bắt buộc

Số phiên tối đa mỗi trang, giới hạn 100.

Lấy phiên

GET

https://babel.withkaleo.com

/v1/church/{churchId}/sessions/{sessionId}

Bearer (API key)

Đọc một phiên và phân tích người xem của nó.

Lấy phiên › Tham số đường dẫn

churchId

string · bắt buộc

ID nhà thờ của bạn. Sao chép từ trang API (dưới mục Tích hợp) trong bảng điều khiển.

sessionId

string · bắt buộc

ID phiên từ GET /sessions.

Lấy phiên › Phản hồi

Thành công

SessionDetails

HistorySession · bắt buộc