📺 Liệt kê các bản ghi (recordings) của một phiên live event cụ thể¶

GET¶

https://lms-api.swiftfederation.com/v7.4.0/live_event_job/recordings/{app}/{stream}

Yêu cầu (Request)¶

Headers
Content-Type: application/json; charset=UTF-8
Authorization: <token của bạn>
Tham số đường dẫn (Path Parameters)

Trường	Bắt buộc	Mô tả
app	Có	Tên của ứng dụng (app name)
stream	Có	Tên của luồng (stream name)

Tham số truy vấn (Query Parameters) (Tùy chọn)

Trường	Mô tả
page_offset	Vị trí offset trang, mặc định là `0`
page_length	Số lượng mục trên mỗi trang, mặc định là `20`

Phản hồi (Response)¶

Nội dung Body

Trường	Kiểu dữ liệu	Mô tả
request_id	String	ID duy nhất của yêu cầu HTTP hiện tại
recordings	Array	Danh sách các Đối tượng Recording (Recording Object)

Ví dụ¶

Yêu cầu:¶

GET https://lms-api.swiftfederation.com/v7.4.0/live_event_job/recordings/lms_demo/this_is_a_demo
Content-Type: application/json; charset=UTF-8
Authorization: Bearer YOUR_ACCESS_TOKEN

Phản hồi:¶

{
  "request_id": "bd9fea0cb9a441c6a99b819d90bcf2fa.19.16351470701230001",
  "recordings": [
    {
      "app": "a2021091703",
      "stream": "s20210917",
      "status": "success",
      "started": 1631877774041,
      "ended": 1631878000625,
      "origin": {
        "protocol": "hls",
        "manifest": "/20210916/a2021091703/s20210917/4095200B0BEC2C0454B80B0A35586915/recording-master.m3u8",
        "playlist": [
          {
            "preset": "360H",
            "uri": "/20210916/a2021091703/s20210917/4095200B0BEC2C0454B80B0A35586915/360H-123/recording.m3u8"
          },
          {
            "preset": "transmux",
            "uri": "/20210916/a2021091703/s20210917/4095200B0BEC2C0454B80B0A35586915/transmux-123/recording.m3u8"
          }
        ]
      }
    }
  ]
}

Giải thích thêm:¶

request_id: Dùng để đối chiếu khi cần hỗ trợ kỹ thuật hoặc theo dõi yêu cầu.
recordings: Danh sách các bản ghi (recordings) tìm được. Mỗi bản ghi sẽ có:
app: Tên ứng dụng.
stream: Tên luồng.
status: Trạng thái của bản ghi (success, failed, v.v.).
started và ended: Thời gian bắt đầu và kết thúc (dưới dạng UNIX timestamp).
origin: Thông tin về bản ghi nguồn, bao gồm:
- protocol: Giao thức (ví dụ: HLS).
- manifest: Đường dẫn tới file manifest chính.
- playlist: Danh sách các file phụ thuộc theo các preset độ phân giải.