Skip to Content
DocumentationAPI ReferenceSiaran Langsung

Siaran Langsung API

Siaran Langsung API menyediakan endpoint untuk menemukan dan mengambil informasi tentang acara siarannya. Ini memungkinkan Anda untuk membuat direktori “Langsung Sekarang” dan memasukkan pemain langsung ke aplikasi Anda.

Dapatkan Siaran Langsung Aktif

Endpoint ini adalah utama untuk menemukan siaran yang sedang “on-air”. Ia akan mengembalikan daftar hanya siaran yang aktif menerima sinyal dari encoder.

GET /live-streams/active

Parameter

Endpoint ini tidak memiliki parameter apa pun. Ia akan mengembalikan semua siaran aktif untuk akun Anda.

Contoh Permintaan

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

Respons: GET /live-streams/active

Jika siaran aktif, Anda akan menerima array objek LiveStream. Statusnya akan aktif dan objek manifest akan hadir.

Respons: 200 OK (Siaran Aktif)
{
  "data": [
    {
      "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
      "title": "Sesi Tanya Jawab Mingguan",
      "description": "Mengjawab pertanyaan Anda langsung.",
      "status": "aktif",
      "manifest": {
        "hls_url": "https://your-app.com/storage/live_media/live/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptive/master.m3u8"
      },
      "metadata": {
        "kategori": "Diskusi Teknologi",
        "host": "Jane Doe"
      },
      "tags": ["langsung", "tanya jawab"],
      "created_at": "2024-08-01T10:00:00Z"
    }
  ]
}

Jika tidak ada siaran aktif, API akan mengembalikan array data kosong.

Respons: 200 OK (Tidak Ada Siaran Aktif)
{
  "data": []
}

Dapatkan Semua Siaran Langsung

Endpoint ini menyediakan direktori yang dihalaman untuk semua siaran langsung yang terkonfigurasi dalam akun Anda, tanpa peduli statusnya (aktif atau tidak aktif). Ini berguna untuk membuat jadwal atau daftar channel yang tersedia.

GET /live-streams

Parameter

NamaTipeDiperlukanDeskripsi
per_pageintegerOpsionalJumlah siaran untuk dikembalikan per halaman. Default: 15, Maksimum: 100.

Contoh Permintaan

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

Respons: GET /live-streams

Respons adalah daftar yang dihalaman standar. Statusnya akan aktif atau tidak aktif, dan objek manifest hanya akan hadir untuk siaran aktif.

Respons: 200 OK
{
  "data": [
    {
      "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
      "title": "Sesi Tanya Jawab Mingguan",
      "description": "Mengjawab pertanyaan Anda langsung.",
      "status": "aktif",
      "manifest": {
        "hls_url": "https://your-app.com/storage/live_media/live/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptive/master.m3u8"
      },
      "metadata": {
        "kategori": "Diskusi Teknologi"
      },
      "tags": ["langsung", "tanya jawab"],
      "created_at": "2024-08-01T10:00:00Z"
    },
    {
      "id": "9c1a9e3e-1a2b-3c4d-5e6f-7g8h9i0j1k2l",
      "title": "Peluncuran Produk Masa Depan",
      "description": "Join kami untuk pengecekan besar.",
      "status": "tidak aktif",
      "metadata": {
        "kategori": "Produk"
      },
      "tags": ["peluncuran", "acara"],
      "created_at": "2024-07-25T15:00:00Z"
    }
  ],
  "links": {
    "pertama": "https://your-app.com/api/client/v1/live-streams?page=1",
    "terakhir": "https://your-app.com/api/client/v1/live-streams?page=3",
    "sebelumnya": null,
    "berikutnya": "https://your-app.com/api/client/v1/live-streams?page=2"
  },
  "meta": {
    "halaman saat ini": 1,
    "dari": 1,
    "halaman terakhir": 3,
    "path": "https://your-app.com/api/client/v1/live-streams",
    "per_halaman": 2,
    "sampai": 2,
    "total": 6
  }
}

Dapatkan Siaran Langsung Tunggal

Mengambil detail lengkap untuk satu siaran langsung tertentu berdasarkan ID-nya. Ini adalah endpoint yang akan Anda panggil untuk mendapatkan informasi yang diperlukan untuk memuat siaran ke pemain.

GET /live-streams/{streamId}

Parameter Jalur

NamaTipeDeskripsi
streamIduuidDiperlukan. ID unik dari siaran langsung.

Contoh Permintaan

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

Respons: GET /live-streams/{streamId}

Respons adalah objek LiveStream tunggal. Objek manifest akan hadir jika siaran aktif.

Respons: 200 OK (Siaran Aktif)
{
  "data": {
    "id": "9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f",
    "title": "Sesi Tanya Jawab Mingguan",
    "description": "Mengjawab pertanyaan Anda langsung.",
    "status": "aktif",
    "manifest": {
      "hls_url": "https://your-app.com/storage/live_media/live/9c1a9e3e-7d8c-5g9b-9f1c-8a2b0c3d9e8f/adaptive/master.m3u8"
    },
    "metadata": {
      "kategori": "Diskusi Teknologi",
      "host": "Jane Doe"
    },
    "tags": ["langsung", "tanya jawab"],
    "created_at": "2024-08-01T10:00:00Z"
  }
}
VideoUpload Video