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).
/api/v1/amiri/allChannel zote zinazotumika kwa ombi moja: { count, channels: [...], unavailable: [...] }. Kila channel ina mpd_url yenye token mpya, ClearKey na logo_url (ikiwepo).
/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.
| Sehemu | Maelezo |
|---|---|
| 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" } ]
}
| Field | Maana |
|---|---|
logo_url | Link ya logo ya channel (http/https), picha iliyopakiwa (data:image/...;base64,...), au null isipowekwa |
mpd_url | Link ya MPD ya kucheza |
token | Token iliyomo kwenye link |
clearkey | ClearKey ya kwanza, kid:key |
clearkeys | Funguo zote kama { kid: key } (Shaka / ExoPlayer) |
expires_at | Daima 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
| Code | Maana | Cha kufanya |
|---|---|---|
| 401 | API Key haipo au si sahihi | Hakikisha header X-API-Key |
| 403 | Hakuna kifurushi kinachotumika, kimeisha, au akaunti imesimamishwa | Lipia au ongeza kifurushi |
| 404 | Channel haipo | Angalia jina la channel |
| 429 | Maombi mengi mno | Subiri kidogo, jaribu tena |
| 503 | Chanzo hakipatikani kwa sasa | Jaribu 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.