Skip to Content
DocumentationAPI ReferenceTransmisii live

Fluxul Live API

Fluxul Live API oferă endpoint-uri pentru descoperire și recuperare a informațiilor despre evenimentele tale live. Acest lucru îți permite să construiești „Directori Live Acum” și să încarci jucători live în aplicațiile tale.

Obține Fluxurile Active

Acest este endpoint-ul principal pentru descoperirea fluxurilor care sunt „în funcțiune”. Returnează o listă cu doar fluxurile active care primesc semnal de la un encoder.

GET /live-streams/active

Parametrii

Acest endpoint nu primește niciun parametrul. Va returna toate fluxurile active pentru contul tău.

Exemplu de cerere

GET /api/client/v1/live-streams/active
Host: https://your-app.com
Autorizare: Bearer sk-your-api-key-here

Răspuns: GET /live-streams/active

Dacă fluxurile sunt active, vei primi un array de obiecte LiveStream. Status-ul va fi active și un obiect manifest va fi prezent.

Răspuns: 200 OK (Fluxuri Active)
{
  "data": [
    {
      "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
      "titlu": "Sesiunea de întrebări săptămânală",
      "descriere": "Răspund la întrebările tale live.",
      "status": "active",
      "manifest": {
        "hls_url": "https://your-app.com/storage/live_media/live/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptive/master.m3u8"
      },
      "metadata": {
        "categorie": "Discuții tehnice",
        "gazda": "Jane Doe"
      },
      "etichete": ["live", "q&a"],
      "creat_at": "2024-08-01T10:00:00Z"
    }
  ]
}

Dacă nu există fluxuri active în prezent, API va returna un array gol.

Răspuns: 200 OK (Nu există Fluxuri Active)
{
  "data": []
}

Obține Toate Fluxurile Live

Acest endpoint oferă un director paginat cu toate fluxurile live configurate în contul tău, indiferent de starea lor curentă (activ sau inactiv). Acest lucru este util pentru construirea unui calendar sau o listă completă a canalelor disponibile.

GET /live-streams

Parametrii

NumeTipObligatoriuDescriere
per_pageintegerOpționalNumărul de fluxuri să se returneze pe pagină. Implicit: 15, Max: 100.

Exemplu de cerere

GET /api/client/v1/live-streams?per_page=2

Răspuns: GET /live-streams

Răspunsul este o listă standard paginată. Status-ul va fi active sau inactive, și obiectul manifest va fi prezent doar pentru fluxurile active.

Răspuns: 200 OK
{
  "data": [
    {
      "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
      "titlu": "Sesiunea de întrebări săptămânală",
      "descriere": "Răspund la întrebările tale live.",
      "status": "active",
      "manifest": {
        "hls_url": "https://your-app.com/storage/live_media/live/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptive/master.m3u8"
      },
      "metadata": {
        "categorie": "Discuții tehnice"
      },
      "etichete": ["live", "q&a"],
      "creat_at": "2024-08-01T10:00:00Z"
    },
    {
      "id": "9c1a9e3e-1a2b-3c4d-5e6f-7g8h9i0j1k2l",
      "titlu": "Lansarea produsului viitoare",
      "descriere": "Uneteți-vă la marele moment.",
      "status": "inactive",
      "metadata": {
        "categorie": "Produse"
      },
      "etichete": ["lanț", "eveniment"],
      "creat_at": "2024-07-25T15:00:00Z"
    }
  ],
  "legături": {
    "primul": "https://your-app.com/api/client/v1/live-streams?page=1",
    "ultimul": "https://your-app.com/api/client/v1/live-streams?page=3",
    "precedent": null,
    "următor": "https://your-app.com/api/client/v1/live-streams?page=2"
  },
  "meta": {
    "pagina curentă": 1,
    "de la": 1,
    "ultima pagină": 3,
    "câmp": "https://your-app.com/api/client/v1/live-streams",
    "per_page": 2,
    "până la": 2,
    "total": 6
  }
}

Obține un singur flux live

Retrimite detalii complete pentru un singur flux live, identificat prin ID-ul său. Acest este endpoint-ul pe care îl vei apela pentru a obține informațiile necesare pentru încărcarea unui flux într-un jucător.

GET /live-streams/{streamId}

Parametrii de căutare

NumeTipDescriere
streamIduuidObligatoriu. Identificator unic al fluxului live.

Exemplu de cerere

GET /api/client/v1/live-streams/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f

Răspuns: GET /live-streams/{streamId}

Răspunsul este un singur obiect LiveStream. Manifest-ul va fi inclus dacă fluxul este activ.

Răspuns: 200 OK (Fluxul este Activ)
{
  "data": {
    "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
    "titlu": "Sesiunea de întrebări săptămânală",
    "descriere": "Răspund la întrebările tale live.",
    "status": "active",
    "manifest": {
      "hls_url": "https://your-app.com/storage/live_media/live/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptive/master.m3u8"
    },
    "metadata": {
      "categorie": "Discuții tehnice",
      "gazda": "Jane Doe"
    },
    "etichete": ["live", "q&a"],
    "creat_at": "2024-08-01T10:00:00Z"
  }
}
VideoclipuriÎncărcarea de video-uri