Skip to Content
DocumentationAPI ReferenceTransmisje na żywo

Transmisje na żywo API

Transmisja na żywo API zapewnia punkty końcowe do odkrywania i pobierania informacji o Twoich wydarzeniach na żywo. Pozwala to budować katalogi “Na żywo” oraz wstawiać gracze na żywo do aplikacji.

Pobierz aktywną transmisję na żywo

To jest główny punkt końcowy do odkrywania strumieni, które są aktualnie “na żywo”. Zwraca listę tylko tych strumieni, które aktywnie otrzymują sygnał z kodera.

GET /transmisje-na-zywo/aktywne

Parametry

Ten punkt końcowy nie przyjmuje żadnych parametrów. Zwróci wszystkie aktywne strumienie dla Twojego konta.

Przykładowe zapytanie

GET /api/client/v1/transmisje-na-zywo/aktywne
Host: https://twoja-aplikacja.com
Autoryzacja: Bearer sk-twojego-api-klucza-tutaj

Odpowiedź: GET /transmisje-na-zywo/aktywne

Jeśli strumienie są aktywne, otrzymasz tablicę obiektów LiveStream. Status będzie równy active i zostanie przedstawiony obiekt manifest.

Odpowiedź: 200 OK (Strumienia Aktywne)
{
  "data": [
    {
      "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
      "title": "Tygodniowa Sesja Q&A",
      "description": "Odpowiedź na Twoje pytania na żywo.",
      "status": "active",
      "manifest": {
        "hls_url": "https://twoja-aplikacja.com/storage/transmisje-na-zywo/live/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptive/master.m3u8"
      },
      "metadata": {
        "kategoria": "Rozmowa techniczna",
        "gospodarz": "Jane Doe"
      },
      "tagi": ["na żywo", "q&a"],
      "utworzono": "2024-08-01T10:00:00Z"
    }
  ]
}

Jeśli żaden strumień nie jest aktualnie aktywny, API zwróci pustą tablicę danych.

Odpowiedź: 200 OK (Brak Aktywnych Strumieni)
{
  "data": []
}

Pobierz wszystkie transmisje na żywo

Ten punkt końcowy zapewnia katalog paginowany wszystkich konfigurowanych strumieni na żywo w Twoim koncie, niezależnie od ich aktualnego statusu (aktywnego lub nieaktywnego). Jest to przydatne do budowania harmonogramu lub pełnej listy dostępnych kanałów.

GET /transmisje-na-zywo

Parametry

NazwaTypWymaganeOpis
per_pageintegerOpcjonalnieLiczba strumieni do zwrócenia na stronie. Domyślnie: 15, Maksimum: 100.

Przykładowe zapytanie

GET /api/client/v1/transmisje-na-zywo?per_page=2

Odpowiedź: GET /transmisje-na-zywo

Odpowiedź jest standardową listą paginowaną. Status będzie równy active lub inactive, a obiekt manifest zostanie przedstawiony tylko dla aktywnych strumieni.

Odpowiedź: 200 OK
{
  "data": [
    {
      "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
      "title": "Tygodniowa Sesja Q&A",
      "description": "Odpowiedź na Twoje pytania na żywo.",
      "status": "active",
      "manifest": {
        "hls_url": "https://twoja-aplikacja.com/storage/transmisje-na-zywo/live/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptive/master.m3u8"
      },
      "metadata": {
        "kategoria": "Rozmowa techniczna"
      },
      "tagi": ["na żywo", "q&a"],
      "utworzono": "2024-08-01T10:00:00Z"
    },
    {
      "id": "9c1a9e3e-1a2b-3c4d-5e6f-7g8h9i0j1k2l",
      "title": "Nadchodzące Wydarzenie Produktowe",
      "description": "Dołącz do wielkiej prezentacji.",
      "status": "nieaktywny",
      "metadata": {
        "kategoria": "Produkt"
      },
      "tagi": ["wydarzenie", "prezentacja"],
      "utworzono": "2024-07-25T15:00:00Z"
    }
  ],
  "linki": {
    "pierwszy": "https://twoja-aplikacja.com/api/client/v1/transmisje-na-zywo?page=1",
    "ostatni": "https://twoja-aplikacja.com/api/client/v1/transmisje-na-zywo?page=3",
    "poprzedni": null,
    "następny": "https://twoja-aplikacja.com/api/client/v1/transmisje-na-zywo?page=2"
  },
  "meta": {
    "aktualna_strona": 1,
    "od": 1,
    "ostatnia_strona": 3,
    "ścieżka": "https://twoja-aplikacja.com/api/client/v1/transmisje-na-zywo",
    "per_page": 2,
    "do": 2,
    "ogółem": 6
  }
}

Pobierz pojedynczą transmisję na żywo

Pobiera pełne szczegóły jednej konkretnej transmisji na żywo przez jej ID. Jest to punkt końcowy, który wywoła się do pobrania niezbędnych informacji do załadunku strumienia w gracz.

GET /transmisje-na-zywo/{streamId}

Parametry drogowe

NazwaTypOpis
streamIduuidWymagane. Unikalny identyfikator strumienia na żywo.

Przykładowe zapytanie

GET /api/client/v1/transmisje-na-zywo/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f

Odpowiedź: GET /transmisje-na-zywo/{streamId}

Odpowiedź jest pojedynczym obiektem LiveStream. Manifest zostanie przedstawiony, jeśli strumień jest aktywny.

Odpowiedź: 200 OK (Strumień Aktywny)
{
  "data": {
    "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
    "title": "Tygodniowa Sesja Q&A",
    "description": "Odpowiedź na Twoje pytania na żywo.",
    "status": "aktywny",
    "manifest": {
      "hls_url": "https://twoja-aplikacja.com/storage/transmisje-na-zywo/live/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptive/master.m3u8"
    },
    "metadata": {
      "kategoria": "Rozmowa techniczna",
      "gospodarz": "Jane Doe"
    },
    "tagi": ["na żywo", "q&a"],
    "utworzono": "2024-08-01T10:00:00Z"
  }
}
WideoWgranie wideo