Partner Streaming API Documentation

1. Kisa Ozet

Partner site ham stream linki kullanmaz. Bunun yerine once bu API uzerinden event bilgisi alir, sonra belirli bir kullanici icin playback session olusturur ve son olarak donen embedUrl veya playerUrl ile iframe/player acar.

Onerilen entegrasyon modeli: partner frontend degil, partner backend bu API ile gorussun.

4. Entegrasyon Akisi

1. Partner backend event listesini ceker.
2. Kullanici maca tikladiginda partner backend secilen event icin access check veya direkt session create cagirir.
3. Sistem domain, lisans bakiyesi, concurrency ve kullanici kurallarini kontrol eder.
4. Basarili ise session uretilir.
5. Partner frontend, donen embedUrl veya playerUrl ile iframe acar.
6. Player Clappr tabanli playback akisini baslatir ve kendi playback cookie ile session baglamini olusturur.
7. Top-level playlist URL’si session bazli live.json formatinda sunulur; alt playlistler opaque .m3u8, segmentler opaque .jpg asset URL’lerle akar.

5. Partner Tarafindan Gonderilecek Veri

8. Event Detayi

GET /api/partner/events/:id

Belirli bir event’in detayini getirir.

curl -X GET https://DiamondIPTV.com/api/partner/events/evt-001 \
  -H "x-partner-key: YOUR_PARTNER_KEY" \
  -H "x-partner-secret: YOUR_PARTNER_SECRET"

Ornek response:

{
  "ok": true,
  "event": {
    "id": "evt-bcd9e8c2810a",
    "title": "Criciuma vs Botafogo SP",
    "sport": "Football",
    "league": "Serie B",
    "regionName": "Brazil",
    "homeTeam": "Criciuma",
    "awayTeam": "Botafogo SP",
    "startsAt": "2026-04-11T02:30:00+03:00",
    "status": "ended",
    "streamAccessCost": 0,
    "sourceProvider": "mackolik",
    "sourceEventId": "4453723",
    "externalProvider": "betradar",
    "externalEventId": "sr:sport_event:1000001",
    "mappingStatus": "auto-matched"
  }
}

9. Access Check

POST /api/partner/check-access

Session olusturmadan once sadece erisim durumunu kontrol etmek isterseniz bu endpoint kullanilir.

Ornek request:

{
  "eventId": "evt-001",
  "domain": "DiamondIPTV.com",
  "user": {
    "id": "user-42",
    "isLoggedIn": true,
    "balance": 1500,
    "creditLimit": 0
  }
}

Ornek response:

{
  "ok": true,
  "allowed": true,
  "reasons": [],
  "requiredLicenseBalance": 250,
  "remainingLicenseBalance": 30000
}

10. Session Create

POST /api/partner/session

Bu endpoint izleme session’i olusturur. Ana entegrasyon endpoint’i budur.

Ornek request:

{
  "eventId": "evt-001",
  "domain": "DiamondIPTV.com",
  "user": {
    "id": "user-42",
    "isLoggedIn": true,
    "balance": 1500,
    "creditLimit": 0
  }
}

Ornek basarili response:

{
  "ok": true,
  "sessionId": "sess-xxxx",
  "token": "signed-token",
  "expiresAt": "2026-04-12T12:15:00.000Z",
  "embedUrl": "/embed/sess-xxxx",
  "playerUrl": "/player/sess-xxxx",
  "activeViewerCount": 0,
  "maxConcurrentViewers": 2,
  "chargedAmount": 250,
  "remainingLicenseBalance": 29750
}

Partner tavsiyesi: event seciminde once externalEventId dolu mu kontrol edin. Doluysa kendi event referansinizla daha rahat eslesirsiniz. Ancak check-access ve session endpointlerine giderken her zaman bizim id alanimizi gonderin.

Ornek hatali response:

{
  "ok": false,
  "message": "Kullanici bu yayini izleyemez.",
  "reasons": [
    "Partner lisans bakiyesi yetersiz. Gerekli: 250, Kalan: 0"
  ]
}

11. Betco Benzeri Minimum Akis

1. Partner backend GET /api/partner/events ile event listesini ceker.
2. Partner kendi taraftaki event ile bizdeki eventi externalEventId veya id ile esler.
3. Kullanici yayin izlemek istediginde partner backend POST /api/partner/session cagirir.
4. Response icindeki embedUrl frontend iframe alanina yazilir.
5. Player playback cookie ve proxy akislarini kendisi yonetir.

Partner tarafinda ekstra panel, billing veya operasyon endpoint’i implement etmeniz gerekmez.

14. Ornek Partner Backend Akisi

async function openStreamForUser(eventId, user, domain) {
  const response = await fetch("https://DiamondIPTV.com/api/partner/session", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-partner-key": process.env.STREAM_PARTNER_KEY,
      "x-partner-secret": process.env.STREAM_PARTNER_SECRET
    },
    body: JSON.stringify({
      eventId,
      domain,
      user: {
        id: user.id,
        isLoggedIn: user.isLoggedIn,
        balance: user.balance
      }
    })
  });

  const payload = await response.json();
  if (!payload.ok) {
    throw new Error(payload.reasons?.join(" | ") || payload.message);
  }

  return payload.embedUrl;
}

15. Ornek Partner Frontend Akisi

async function onWatchClick(eventId) {
  const response = await fetch("/backend/open-stream", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ eventId })
  });

  const payload = await response.json();
  if (!payload.ok) {
    alert(payload.message || "Yayin acilamadi");
    return;
  }

  document.getElementById("stream-iframe").src = payload.embedUrl;
}

16. Playback Koruma Modeli

• Ham m3u8 partnera verilmez.
• Manifest ve segment istekleri playback gateway uzerinden proxy edilir.
• Manifest icindeki path’ler dogrudan upstream adresleri degil, tokenli ve opaque asset URL’lerdir.
• Top-level oynatim URL’si de session bazli JSON-benzeri bir playlist endpointidir; partner tarafinda upstream HLS yolu gorunmez.
• Player ilk acilista istemciye bagli playback cookie olusturur.
• Session baglami IP ve user-agent ile korunur.
• Bu nedenle sadece player veya manifest linkini kopyalamak genelde yeterli olmaz.

19. Heartbeat ve Session Close

Bu endpointler player tarafinda sistem tarafindan kullanilir; entegrasyon ekibinin ekstra implement etmesi zorunlu degildir.

20. HTTP Status Ozet

21. Onerilen Minimum Entegrasyon

1. Partner backend event listesini ceker.
2. Partner kullanicisi maca tiklar.
3. Partner backend /api/partner/session cagirir.
4. Donen embedUrl iframe’e yazilir.
5. Hepsi bu kadar.

En basit saglam model budur.