Fejlesztői API dokumentáció

közösség

Fejlesztői API

Botokat, fedvényeket, adatfolyam-eszközöket és integrációkat készíthet a D1Arena adataival.

Hitelesítés

Minden API-kéréshez a X-API-Key / Authorization: Bearer fejlécben átadott API-kulcs szükséges.

# Example request
curl -H "X-API-Key: d1_your_api_key_here" \
     https://d1arena.com/api/v1/streams

API-kulcs létrehozásához lépjen a(z) Fejlesztői beállítások címre az irányítópulton. Legfeljebb 5 kulcsod lehet.

Az API-kérelmek sebessége API-kulcsonként korlátozott. Ha túllépi a korlátot, a kérések a következőt adják vissza: 429 Too Many Requests, Retry-After fejléccel.

Alap URL

https://d1arena.com/api/v1

Minden végpont JSON-t ad vissza. A lapozott végpontok tartalmaznak egy meta objektumot a következőkkel: current_page, last_page és total.

Streamek

GET /streams

A jelenleg élő közvetítések listája. Támogatja a lapozást és a kategóriaszűrést.

Paraméter	Írja be	Leírás
`category_id`	integer	Szűrés játék/kategóriaazonosító szerint
`limit`	integer	Eredmények oldalanként (alapértelmezett: 20)
`page`	integer	Oldalszám

Válasz

{
  "data": [
    {
      "id": 42,
      "name": "ProGamer99",
      "user_slug": "progamer99",
      "profile_img": "profile/abc123.jpg",
      "stream_title": "Ranked Grind - Road to Champion",
      "stream_category_id": 5,
      "is_vertical_stream": false,
      "platform_tier": "pro"
    }
  ],
  "meta": { "current_page": 1, "last_page": 1, "total": 3 }
}

GET /streams/{slug}

Nézze meg egyetlen streamelő élő állapotát és a közvetítés részleteit felhasználónév vagy csiga alapján.

Válasz

{
  "data": {
    "user_id": 42,
    "name": "ProGamer99",
    "slug": "progamer99",
    "is_live": true,
    "stream_title": "Ranked Grind",
    "category_id": 5,
    "is_vertical": false,
    "platform_tier": "pro",
    "profile_img": "profile/abc123.jpg"
  }
}

Kategóriák

GET /categories

Sorolja fel az összes játékkategóriát. Támogatja a keresést és a lapozást.

Paraméter	Írja be	Leírás
`search`	string	Kategóriák szűrése név szerint
`limit`	integer	Eredmények oldalanként (alapértelmezett: 50)

Válasz

{
  "data": [
    { "id": 5, "name": "Call of Duty", "slug": "call-of-duty", "image": "categories/cod.png" }
  ],
  "meta": { "total": 24 }
}

Felhasználók

GET /users/{slug}

Szerezzen be egy játékos nyilvános profilját és versenystatisztikáját felhasználónév vagy slussz alapján.

Válasz

{
  "data": {
    "user": {
      "id": 42, "name": "ProGamer99", "user_slug": "progamer99",
      "profile_img": "profile/abc.jpg", "bio": "Competitive FPS player",
      "platform_tier": "pro", "is_live": "1", "stream_title": "Ranked",
      "gold": 3, "silver": 1, "bronze": 0
    },
    "stats": {
      "elo_rating": 1842,
      "total_tournaments": 27,
      "win_rate": 64.5,
      "total_earnings": 1250.00
    }
  }
}

Klipek

GET /clips

Nyilvános klipek listázása. Támogatja a streamer és kategória szerinti szűrést.

Paraméter	Írja be	Leírás
`streamer_id`	integer	Szűrje le a klipeket a streamer felhasználói azonosítója alapján
`category_id`	integer	Szűrés játék/kategóriaazonosító szerint
`limit`	integer	Eredmények oldalanként (alapértelmezett: 20)

Válasz

{
  "data": [
    {
      "id": 99, "streamer_id": 42, "stream_category_id": 5,
      "title": "Insane 1v4 clutch", "slug": "insane-1v4-clutch-abc",
      "duration": 28, "view_count": 412, "is_auto_clip": false,
      "created_at": "2026-03-15T18:30:00.000000Z",
      "streamer": { "id": 42, "name": "ProGamer99", "user_slug": "progamer99" }
    }
  ],
  "meta": { "total": 156 }
}

GET /clips/{slug}

Szerezzen be egyetlen klip részleteit a slug segítségével.

Válasz

{
  "data": {
    "id": 99, "title": "Insane 1v4 clutch", "slug": "insane-1v4-clutch-abc",
    "description": "Final round comeback", "duration": 28, "view_count": 412,
    "streamer": { "id": 42, "name": "ProGamer99" },
    "creator": { "id": 55, "name": "ClipMaster" },
    "stream_category": { "id": 5, "name": "Call of Duty" }
  }
}

Versenyek

GET /tournaments

Sorolja fel a versenyeket. Támogatja az állapot és a liga szerinti szűrést.

Paraméter	Írja be	Leírás
`status`	string	Szűrés állapot szerint (pl. `open`, `in_progress`, `completed`)
`league_id`	integer	Szűrés ligaazonosító alapján
`limit`	integer	Eredmények oldalanként (alapértelmezett: 20)

Válasz

{
  "data": [
    {
      "id": 15,
      "title": "Friday Night Frenzy",
      "tournament_type": "single_elimination",
      "status": "open",
      "registration_fee": "5.00",
      "no_player": 32,
      "team": 0,
      "category": { "id": 5, "name": "Call of Duty" },
      "start_date": "2026-03-28T20:00:00.000000Z"
    }
  ],
  "meta": { "current_page": 1, "last_page": 2, "total": 24 }
}

GET /tournaments/{id}

Szerezze meg a verseny részleteit és a résztvevők számát.

Válasz

{
  "data": {
    "id": 15, "title": "Friday Night Frenzy", "tournament_type": "single_elimination",
    "status": "open", "registration_fee": "5.00", "no_player": 32, "team": 0
  },
  "meta": { "participant_count": 18 }
}

ELO Rangsorok

GET /elo/leaderboard

Szerezd meg az ELO-ranglistát. Opcionálisan szűrhet játékkategória szerint.

Paraméter	Írja be	Leírás
`category_id`	integer	Szűrés játék/kategóriaazonosító szerint
`limit`	integer	Eredmények száma (alapértelmezett: 50)

Válasz

{
  "data": [
    {
      "rank": 1,
      "user_id": 42,
      "name": "ProGamer99",
      "user_slug": "progamer99",
      "elo_rating": 2150,
      "wins": 45,
      "losses": 12,
      "win_rate": 78.9,
      "profile_img": "profile/abc123.jpg"
    }
  ],
  "meta": { "total": 312 }
}

Ligák

GET /leagues

Liga listázása opcionális állapot- és kategóriaszűrőkkel.

Paraméter	Írja be	Leírás
`status`	string	Szűrés bajnoki állapot szerint
`category_id`	integer	Szűrés játék/kategóriaazonosító szerint
`limit`	integer	Eredmények oldalanként (alapértelmezett: 20)

Válasz

{
  "data": [
    {
      "id": 3,
      "name": "Spring 2026 Pro League",
      "status": "active",
      "category": { "id": 5, "name": "Call of Duty" },
      "total_participants": 48,
      "start_date": "2026-03-01",
      "end_date": "2026-05-31"
    }
  ],
  "meta": { "current_page": 1, "last_page": 1, "total": 6 }
}

GET /leagues/{id}/standings

Szerezze meg a bajnokság állását (a játékosok helyezése pontok szerint).

Válasz

{
  "data": [
    {
      "id": 1, "points": 2400, "wins": 12, "losses": 3,
      "user": { "id": 42, "name": "ProGamer99", "user_slug": "progamer99" }
    }
  ],
  "meta": { "total": 48 }
}

Hibaválaszok

Minden hiba következetes JSON-borítékot ad vissza. A error objektum mindig tartalmaz egy géppel olvasható code és egy ember által olvasható message elemet.

Hibaválasz formátuma

{
  "success": false,
  "error": {
    "code": "not_found",
    "message": "The requested resource could not be found."
  }
}

Érvényesítési hiba formátuma (422)

{
  "success": false,
  "error": {
    "code": "validation_error",
    "message": "The given data was invalid.",
    "errors": {
      "category_id": ["The category id must be an integer."],
      "limit": ["The limit must not be greater than 100."]
    }
  }
}

Állapotkódok

200

OK — A kérés sikerült. A válasz tartalmazza a kért adatokat.

400

Rossz kérés — A kérelem hibás, vagy hiányoznak a szükséges paraméterek. A részletekért tekintse meg a error.message-t.

401

Jogosulatlan — Missing or invalid API key. Ensure you're passing a valid key in the X-API-Key header.

403

Tilos — API-kulcsa le van tiltva, vagy nincs engedélye ehhez az erőforráshoz. Ellenőrizze a Fejlesztői beállítások.

404

Nem található — A kért erőforrás nem létezik. Ellenőrizze a csigát, az azonosítót vagy a végpont elérési útját.

422

Érvényesítési hiba — A kérés paramétereinek ellenőrzése sikertelen. A error.errors objektum a mezőneveket a konkrét problémákhoz rendeli hozzá.

429

Rate Limited — Túl sok kérés. A Retry-After fejléc azt jelzi, hogy hány másodpercet kell várni az újrapróbálkozás előtt.

500

Szerver hiba — Váratlan hiba történt a mi oldalunkon. Ha ez továbbra is fennáll, lépjen kapcsolatba a támogatással.

Hibakódok hivatkozása

kód	HTTP állapot	Leírás
`invalid_api_key`	401	Az API-kulcs hiányzik, rosszul formázott vagy nem létezik
`api_key_disabled`	403	Az API-kulcsot visszavonták vagy letiltották
`not_found`	404	A kért erőforrás nem található
`validation_error`	422	Egy vagy több kérésparaméter érvénytelen
`rate_limited`	429	Túllépte az API-kulcs kérési gyakorisági korlátját
`server_error`	500	Belső szerverhiba – próbálkozzon újra, vagy lépjen kapcsolatba a támogatással

Rate Limits

Az API-kérelmek sebessége API-kulcsonként korlátozott. Ha túllépi a korlátot, a kérések a következőt adják vissza: 429 Too Many Requests, Retry-After fejléccel.

Korlátozások szint szerint

Szint	Kérések / jegyzőkönyv (Alapértelmezett)	Max Keys
Indító (ingyenes)	60	5
PRO	60	5
Végső	60	5
Partner	60	5

Rate Limit fejlécek

Az API-kérelmek sebessége API-kulcsonként korlátozott. Ha túllépi a korlátot, a kérések a következőt adják vissza: 429 Too Many Requests, Retry-After fejléccel.

Fejléc	Leírás
`Retry-After`	Másodpercek az újrapróbálkozás előtt (csak 429 válasz esetén)

Legjobb gyakorlatok

Tippek a határok betartásához:

Cache responses locally — stream and tournament data doesn't change every second.
Iratkozzon fel a(z) webhooks szolgáltatásra a valós idejű eseményekért a lekérdezési végpontok helyett.
Kötegelt kérések, ahol lehetséges – használjon szűrőparamétereket, hogy kevesebb hívással pontosan azt kapja meg, amire szüksége van.

Webhooks (EventSub)

Feliratkozás a valós idejű push értesítésekre szavazás helyett. Amikor egy esemény bekövetkezik, a D1Arena HTTP POST-ot küld a visszahívási URL-címére egy HMAC-SHA256-tal aláírt JSON-adattartalommal.

Beállítás

Webhook-előfizetések létrehozása itt: Fejlesztői beállítások. Minden előfizetéshez szükséges:

Visszahívási URL — Nyilvánosan elérhető HTTPS-végpont a kiszolgálón.
Események — Egy vagy több eseménytípusra elő kell iratkozni.

You'll receive a whsec_ signing secret upon creation. Store it securely — it's shown only once.

Payload formátum

Minden webhook kézbesítés egy JSON törzset küld a következő szerkezettel:

{
  "id": "evt_a1b2c3d4e5f6",
  "event": "stream.online",
  "created_at": "2026-03-23T14:30:00Z",
  "data": {
    // Event-specific fields (see examples below)
  }
}

Fejlécek

Minden szállítás a következő fejléceket tartalmazza az útválasztáshoz és ellenőrzéshez:

Fejléc	Leírás
`Content-Type`	`application/json`
`X-D1Arena-Event`	Esemény típusa (pl. `stream.online`)
`X-D1Arena-Signature`	HMAC-SHA256 hexa kivonat a nyers kérés törzséből
`X-D1Arena-Signature-Version`	Aláíró kulcs formátuma: `v2` a jelenlegi előfizetésekhez vagy `v1-hashed-secret` a régi előfizetésekhez
`X-D1Arena-Delivery-Id`	Egyedi kézbesítési UUID – használat deduplikációhoz
`X-D1Arena-Timestamp`	Unix időbélyeg az esemény elküldésének időpontjáról

Aláírások ellenőrzése

A webhook feldolgozása előtt mindig ellenőrizze a X-D1Arena-Signature fejlécet. Az aláírás a következőképpen kerül kiszámításra: HMAC-SHA256(raw_body, webhook_secret).

v2 szállításokhoz használja az előfizetés létrehozásakor megjelenő whsec_ titkot. A frissítés előtti v1-hashed-secret kézbesítéshez először számítsa ki a SHA256(whsec_secret) értéket az eredeti titkosításból, és használja a kapott kisbetűs hexadecimális kivonatot HMAC kulcsként. Ha lehetséges, hozza létre újra az előfizetést, hogy áttérjen a v2 oldalra.

PHP

// Get the raw body and signature header
$payload   = file_get_contents('php://input');
$signature = $_SERVER['HTTP_X_D1ARENA_SIGNATURE'] ?? '';

// Compute expected signature
$expected = hash_hmac('sha256', $payload, $webhookSecret);

// Constant-time comparison to prevent timing attacks
if (!hash_equals($expected, $signature)) {
    http_response_code(401);
    exit('Invalid signature');
}

$event = json_decode($payload, true);

Node.js

const crypto = require('crypto');

app.post('/webhook', (req, res) => {
  const payload   = req.rawBody; // Ensure raw body is available
  const signature = req.headers['x-d1arena-signature'];
  const expected  = crypto
    .createHmac('sha256', WEBHOOK_SECRET)
    .update(payload)
    .digest('hex');

  if (!crypto.timingSafeEqual(
    Buffer.from(expected), Buffer.from(signature)
  )) {
    return res.status(401).send('Invalid signature');
  }

  const event = JSON.parse(payload);
  // Process event...
  res.status(200).send('OK');
});

Python

import hmac, hashlib, json

def handle_webhook(request):
    payload   = request.body
    signature = request.headers.get('X-D1Arena-Signature', '')
    expected  = hmac.new(
        WEBHOOK_SECRET.encode(), payload, hashlib.sha256
    ).hexdigest()

    if not hmac.compare_digest(expected, signature):
        return HttpResponse(status=401)

    event = json.loads(payload)
    # Process event...
    return HttpResponse(status=200)

Rendelkezésre álló események

Esemény	Leírás
stream.online	Egy streamer élőben indult
stream.offline	Egy streamer offline állapotba került
channel.follow	Egy felhasználó követett egy csatornát
channel.subscribe	Új támogatói előfizetés egy csatornán
channel.tip	Egy tippet küldtek egy streamernek
tournament.started	Megkezdődött a torna mérkőzése
tournament.ended	Egy torna lezárult
tournament.match.completed	A mérkőzés eredményét rögzítették
clip.created	Új klip készült élő közvetítésből
overdrive.started	A D1 Frenzy egy csatornán indult
overdrive.level_up	A D1 Frenzy a következő szintre lépett
overdrive.ended	D1 Frenzy befejeződött vagy lejárt

Esemény hasznos terhelés példák

stream.online

{
  "id": "evt_a1b2c3d4e5f6",
  "event": "stream.online",
  "created_at": "2026-03-23T14:30:00Z",
  "data": {
    "user_id": 42,
    "user_slug": "progamer99",
    "name": "ProGamer99",
    "stream_title": "Ranked Grind - Road to Champion",
    "category_id": 5,
    "category_name": "Call of Duty",
    "protocol": "RTMP",
    "started_at": "2026-03-23T14:30:00Z"
  }
}

stream.offline

{
  "id": "evt_f6e5d4c3b2a1",
  "event": "stream.offline",
  "created_at": "2026-03-23T17:45:00Z",
  "data": {
    "user_id": 42,
    "user_slug": "progamer99",
    "duration_seconds": 11700,
    "vod_id": 281
  }
}

channel.follow

{
  "id": "evt_c1d2e3f4a5b6",
  "event": "channel.follow",
  "created_at": "2026-03-23T15:10:00Z",
  "data": {
    "follower_id": 88,
    "follower_slug": "newplayer",
    "followed_id": 42,
    "followed_slug": "progamer99"
  }
}

channel.tip

{
  "id": "evt_d1e2f3a4b5c6",
  "event": "channel.tip",
  "created_at": "2026-03-23T16:20:00Z",
  "data": {
    "streamer_id": 42,
    "streamer_slug": "progamer99",
    "tipper_id": 55,
    "tipper_slug": "clipmaster",
    "amount": "5.00",
    "currency": "USD",
    "message": "Great stream!"
  }
}

tournament.match.completed

{
  "id": "evt_e1f2a3b4c5d6",
  "event": "tournament.match.completed",
  "created_at": "2026-03-23T21:15:00Z",
  "data": {
    "tournament_id": 15,
    "tournament_title": "Friday Night Frenzy",
    "match_id": 204,
    "round": 2,
    "winner": { "id": 42, "slug": "progamer99", "name": "ProGamer99" },
    "loser": { "id": 77, "slug": "rival_x", "name": "Rival_X" },
    "score": "3-1"
  }
}

clip.created

{
  "id": "evt_b1c2d3e4f5a6",
  "event": "clip.created",
  "created_at": "2026-03-23T15:45:00Z",
  "data": {
    "clip_id": 99,
    "slug": "insane-1v4-clutch-abc",
    "title": "Insane 1v4 clutch",
    "duration": 28,
    "streamer_id": 42,
    "streamer_slug": "progamer99",
    "creator_id": 55,
    "creator_slug": "clipmaster",
    "category_id": 5
  }
}

Szállítási és újrapróbálkozási szabályzat

Kísérlet	Késleltetés	Megjegyzések
1. (kezdeti)	Azonnali	Az eseményt követő másodperceken belül elküldték
2. (újrapróbálkozás)	30 másodperc	Ha az első próbálkozás sikertelen vagy időtúllépés esetén
3. (újrapróbálkozás)	2 perc	Exponenciális visszalépés
4. (döntő)	10 perc	Utolsó próbálkozás a sikertelenként való megjelölés előtt

Important: Your endpoint must respond with a 2xx status within 10 másodperc. Non-2xx responses or timeouts trigger a retry. After 10 egymást követő hiba, the subscription is automatically disabled. You'll receive an email notification and can re-enable it in Fejlesztői beállítások.

Legjobb gyakorlatok

Mindig ellenőrizze az aláírásokat a hasznos terhek feldolgozása előtt a hamis események megelőzése érdekében.
Használja a Delivery-Id-t a duplikáció megszüntetéséhez — Az újrapróbálkozások ugyanazt az azonosítót küldik, ezért tárolja a feldolgozott azonosítókat a kettős feldolgozás elkerülése érdekében.
Gyorsan válaszoljon, aszinkron módon dolgozzon — azonnal küldje vissza 200 OK-ot, és kezelje az üzleti logikát egy háttérmunkában.
Csak HTTPS-végpontokat használjon — A webhook URL-eknek TLS-t kell használniuk. A HTTP-visszahívások elutasítva.
Kezelje az ismeretlen eseményeket kecsesen — új eseménytípusok adhatók hozzá. Adja vissza a(z) 200 értéket a fel nem ismert eseményekért, nem pedig tévedésért.

D1 Őrület

A D1 Frenzy-t gyors tippek és előfizetések váltják ki, miközben egy streamer él. Növekvő célokkal 5 szinten halad át.

GET `/api/overdrive/{streamerId}`

Szerezd meg az aktív D1 Frenzy-t egy streamerhez. {"active": false} értéket ad vissza, ha nincs.

{
  "active": true,
  "level": 2,
  "progress": 150,
  "target": 250,
  "progress_pct": 60.0,
  "total_contributions": 8,
  "total_contributors": 5,
  "expires_at": "2026-03-22T15:30:00+00:00"
}

Szintcélok

Szint	Pontok
1	100
2	250
3	500
4	1,000
5	2,000

D1 Őrület — Pontok: Tipp $1 → 100; Előfizetés 500 × Szint. Időtartam: 5 Jegyzőkönyv; Lehűlés: 30 Jegyzőkönyv.

Kiterjesztés SDK

Hozzon létre egyéni panel- és fedvénybővítményeket, amelyeket a streamelők telepíthetnek csatornaoldalaikra. A bővítmények sandboxba helyezett iframe-ekben futnak, és a(z) postMessage segítségével kommunikálnak a gazdagéppel.

Kezdő lépések

Hozzon létre egy API-kulcsot itt: Fejlesztői beállítások.
Építse fel bővítményét a domainjén tárolt, önálló HTML-oldalként (HTTPS szükséges).
Küldje be felülvizsgálatra a Saját bővítmények szakaszban.
A jóváhagyást követően a streamerek telepíthetik azt az Extension Marketplace-ről.

Kiterjesztés típusai

Írja be	Helyszín	Viselkedés
`panel`	A stream lejátszó alatt	Akkor látható, ha a közvetítés élő. Teljes szélességű kártya, 300 képpont alapértelmezett magasság.
`overlay`	A videólejátszó felett	Élőben látható. A streamer által vezérelt pozíció/méret az overlay pozicionáló eszközzel.

postMessage API

A bővítmény automatikusan kap környezeti adatokat, amikor betöltődik. Végezze el ezeket az eseményeket:

Minden üzenethez használja a pontos D1Arena szülői eredetet. A hivatalos SDK automatikusan levezeti és ellenőrzi ezt az eredetet a beágyazási oldalról.

Mivel az iframe kiterjesztésű keretek szándékosan átlátszatlan sandbox eredetet használnak, a D1Arena gazdagép pontosan a regisztrált iframe ablakot hitelesíti. A kiterjesztés kódjának továbbra is hitelesítenie kell a szülőablakot és pontos D1Arena eredetet, mielőtt elfogadná a kontextust.

1. Jelkészültség

var d1ParentOrigin = 'https://d1arena.com';

// Tell the host page your extension is ready for context
window.parent.postMessage({ type: 'D1_EXT_READY' }, d1ParentOrigin);

2. Kontextus fogadása

window.addEventListener('message', function(e) {
    if (e.source === window.parent && e.origin === d1ParentOrigin &&
        e.data && e.data.type === 'D1_CONTEXT') {
        var ctx = e.data.payload;
        // ctx.channelId    - Streamer's user ID
        // ctx.channelName  - Streamer's display name
        // ctx.channelSlug  - Streamer's URL slug
        // ctx.viewerId     - Current viewer's ID (null if not logged in)
        // ctx.isLive       - Whether the stream is currently live
    }
});

3. Műveletek küldése (nem kötelező)

// Redirect the host page (e.g. for a "Storm" button)
window.parent.postMessage({ 
    type: 'D1_EXT_ACTION', 
    action: 'storm', 
    target: 'username-slug' 
}, d1ParentOrigin);

Engedélyek hatálya

Adja meg, hogy milyen adatokra van szüksége a bővítménynek. Az ellenőrök ellenőrzik, hogy a kód megfelel-e a deklarált engedélyeknek.

Hatály	Hozzáférést biztosít
`read:stream`	Az adatfolyam állapota, címe, kategóriája
`read:viewers`	Nézőszám és lista
`read:chat`	Chat üzenetek (pusher csatornán keresztül)
`read:clips`	Csatornaklipek a következőn keresztül: `/api/clips/{slug}`
`read:tournaments`	Aktív meccsinformációk a következőn keresztül: `/api/active-match/{id}`
`read:channel`	Csatorna profil, követők, ütemezés

Biztonsági követelmények

A bővítmények egy sandboxed iframe-ban futnak a következővel: sandbox="allow-scripts". Az Ön nem lehet bővítménye hozzáfér a cookie-khoz, a localStorage-hoz, vagy hitelesített kéréseket küldhet a d1arena.com webhelynek.

Nyilvános HTTPS szükséges — Az iframe URL-jének a TLS címet kell használnia, és csak nyilvános hálózati címekre kell feloldania.
Ember által olvasható forrás — Nincs obfuszkált vagy csak minimálisra csökkentett JavaScript. A véleményezőknek el kell tudniuk olvasni a kódot.
Nincs külső szkript betöltése hacsak beadványában nem nyilatkozik. A CDN-könyvtárak (jQuery, Chart.js stb.) megfelelőek.
Nincs adatkiszűrés — A bővítmények nem küldhetnek megtekintői adatokat harmadik féltől származó analitikai vagy nyomkövetési szolgáltatásoknak.
Tartalmi irányelvek — Nincsenek hirdetések, NSFW-tartalom, kriptovaluta bányászat vagy rosszindulatú viselkedés.

Felülvizsgálati folyamat

Állapot	Jelentése
pending	Beküldve, adminisztrátori felülvizsgálatra vár (általában 1-3 munkanap).
approved	Jóváhagyva és látható a bővítmények piacterén.
rejected	Indokkal elutasítva. Javítsa ki a problémákat, és küldje be újra.
suspended	Ideiglenesen eltávolítottuk az irányelvek megsértése miatt. Lépjen kapcsolatba az ügyfélszolgálattal.

Version Updates

Egy jóváhagyott bővítmény frissítéséhez törölje az aktuális verziót, és küldjön be egy újat növekményes verziószámmal. Az új verzió ismét felülvizsgálaton esik át.

Változásnapló

Kövesse nyomon az API változásait és az új funkciókat. Követjük a szemantikus verziószámítást, és legalább 30 nappal korábban bejelentjük a törési változásokat.

v1.02026. március

Első nyilvános API-kiadás API-kulcs hitelesítéssel.
Streamek: Élő közvetítések listázása, a streamelők adatainak lekérése.
Kategóriák: Az összes játékkategória keresése és listázása.
Felhasználók: Nyilvános profilok versenystatisztikával, ELO-besorolással és érmek számával.
Klipek: Böngésszen és kérjen le a klip részleteiről a streamer/alkotói adatok segítségével.
Versenyek: listázás, státusz/bajnokság szerinti szűrés, résztvevők számának lekérése.
ELO ranglista: Globális és kategóriánként rangsorolt ranglisták.
Liga: Liga listája a tabellákkal és pontbontással.
D1 Frenzy: Valós idejű Frenzy állapot bármely streamerhez.
Webhooks (EventSub): 12 eseménytípus, köztük stream, csatorna, verseny, klip és Frenzy események.
Rate Limits

Segítségre van szüksége?

Kérdése van a(z) API-ről? Vegye fel velünk a kapcsolatot.

Fejlesztői API

Fejlesztői API

Hitelesítés

Alap URL

Streamek

Kategóriák

Felhasználók

Klipek

Versenyek

ELO Rangsorok

Ligák

Hibaválaszok

Állapotkódok

Hibakódok hivatkozása

Rate Limits

Korlátozások szint szerint

Rate Limit fejlécek

Legjobb gyakorlatok

Webhooks (EventSub)

Beállítás

Payload formátum

Fejlécek

Aláírások ellenőrzése

Rendelkezésre álló események

Esemény hasznos terhelés példák

stream.online

stream.offline

channel.follow

channel.tip

tournament.match.completed

clip.created

Szállítási és újrapróbálkozási szabályzat

Legjobb gyakorlatok

D1 Őrület

GET /api/overdrive/{streamerId}

Szintcélok

Kiterjesztés SDK

Kezdő lépések

Kiterjesztés típusai

postMessage API

1. Jelkészültség

2. Kontextus fogadása

3. Műveletek küldése (nem kötelező)

Engedélyek hatálya

Biztonsági követelmények

Felülvizsgálati folyamat

Version Updates

Változásnapló

Segítségre van szüksége?

GET `/api/overdrive/{streamerId}`