Channel APIDocumentation
API v1

API Documentation

Pata MPD link, token na ClearKey ya kila channel kwa ombi moja la GET, ukitumia API Key yako binafsi.

GET/api/v1/amiri/all
GET/api/v1/amiri/{jina}
Header: X-API-Key

Muhtasari

API Key binafsi

Kila mtumiaji ana key yake. Inatumwa kwenye header, si kwenye URL.

Endpoint kwa kila source

Kila source ina jina (slug) na ID yake, kwa hivyo zinatofautiana.

Data mpya

Seva inasasisha vyanzo kila dakika chache, kwa hivyo token na ClearKey ni mpya.

Mifano yote hapa ni ya kubuni — si token halisi.

Authentication

Tuma API Key yako kwenye HTTP header X-API-Key. Usiiweke kwenye URL.

X-API-Key: YOUR_PERSONAL_API_KEY

Pata key yako kwenye Dashboard → API Key. Key kamili inaonyeshwa mara moja tu; seva inahifadhi hash yake.

Endpoints

Base URL: https://your-domain.example/api/v1 (tumia HTTPS pekee).

GET/api/v1/amiri/all

Channel zote zinazotumika kwa ombi moja: { count, channels: [...], unavailable: [...] }. Kila channel ina mpd_url yenye token mpya, ClearKey na logo_url (ikiwepo).

GET/api/v1/amiri/{jina}

Channel moja kwa jina lake (mfano azam-sports-1). Inarudisha mpd_url yenye token mpya, pamoja na ClearKey. Majina ya channels zako yanaonekana kwenye Dashboard.

SehemuMaelezo
Header (lazima)X-API-Key
Query (hiari)format=text — majibu kama mistari ya maandishi badala ya JSON

Seva inakagua: key ni halali, akaunti haijasimamishwa, kifurushi ni ACTIVE na hakijaisha, channel inatumika, na token ni mpya (inachukuliwa kila ombi).

Channels

Orodha ya endpoint za channels zinazopatikana sasa.

Ingia ili uone orodha ya channels zako, au angalia Dashboard.

Response

Mafanikio: 200 OK, application/json.

GET /api/v1/amiri/{jina} — channel moja:

{
  "channel": "Channel Name",
  "id": 1,
  "slug": "channel-name",
  "logo_url": "https://example.com/logo.png",
  "mpd_url": "https://example.com/.../manifest.mpd?token=EXAMPLE",
  "token": "EXAMPLE_TOKEN",
  "clearkey": "KID_HEX:KEY_HEX",
  "clearkeys": { "KID_HEX": "KEY_HEX" },
  "expires_at": null
}

GET /api/v1/amiri/all — channel zote kwa ombi moja:

{
  "count": 2,
  "channels": [
    { "channel": "Channel One", "id": 1, "slug": "channel-one", "logo_url": "https://example.com/logo1.png", "mpd_url": "...", "token": "...", "clearkey": "KID_HEX:KEY_HEX", "clearkeys": { "KID_HEX": "KEY_HEX" }, "expires_at": null },
    { "channel": "Channel Two", "id": 2, "slug": "channel-two", "logo_url": null, "mpd_url": "...", "token": "...", "clearkey": null, "clearkeys": {}, "expires_at": null }
  ],
  "unavailable": [ { "channel": "Channel Three", "slug": "channel-three" } ]
}
FieldMaana
logo_urlLink ya logo ya channel (http/https), picha iliyopakiwa (data:image/...;base64,...), au null isipowekwa
mpd_urlLink ya MPD ya kucheza
tokenToken iliyomo kwenye link
clearkeyClearKey ya kwanza, kid:key
clearkeysFunguo zote kama { kid: key } (Shaka / ExoPlayer)
expires_atDaima null: token haiishi, inabadilishwa tu kila ombi
unavailable(kwenye /all tu) channel ambazo source yake haijatoa token bado

Majibu hayahifadhiwi kwenye cache (Cache-Control: no-store).

Error Codes

CodeMaanaCha kufanya
401API Key haipo au si sahihiHakikisha header X-API-Key
403Hakuna kifurushi kinachotumika, kimeisha, au akaunti imesimamishwaLipia au ongeza kifurushi
404Channel haipoAngalia jina la channel
429Maombi mengi mnoSubiri kidogo, jaribu tena
503Chanzo hakipatikani kwa sasaJaribu tena baada ya muda

Mifano

cURL

curl -H "X-API-Key: YOUR_PERSONAL_API_KEY" https://your-domain.example/api/v1/amiri/azam-sports-1

JavaScript

const res = await fetch('https://your-domain.example/api/v1/amiri/azam-sports-1', {
  headers: { 'X-API-Key': 'YOUR_PERSONAL_API_KEY' },
});
if (res.status === 200) {
  const { mpd_url, clearkey, clearkeys } = await res.json();
} else if (res.status === 403) {
  // kifurushi hakipo au kimeisha
}

Python

import requests
r = requests.get("https://your-domain.example/api/v1/amiri/azam-sports-1",
                 headers={"X-API-Key": "YOUR_PERSONAL_API_KEY"}, timeout=10)
print(r.status_code, r.json())

Mipaka & Kifurushi

Kila key ina kikomo cha maombi kwa dakika. Ukivuka unapata 429. Key inafanya kazi tu wakati kifurushi chako ni ACTIVE; kikiisha, key inakuwa INACTIVE hadi ulipie tena.

Tumia data hii kwa vyanzo na maudhui ulivyoidhinishwa kutumia pekee.