Kūrėjo API dokumentacija

bendruomenė

Kūrėjo API

Kurkite robotus, perdangas, srauto įrankius ir integraciją su D1Arena duomenimis.

Autentifikavimas

Visoms API užklausoms reikalingas API raktas, perduotas X-API-Key / Authorization: Bearer antraštėje.

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

Norėdami sukurti API raktą, informacijos suvestinėje eikite į Kūrėjo nustatymai. Galite turėti iki 5 raktų.

API užklausos yra ribojamos pagal API raktą. Kai viršijate limitą, užklausos grąžina 429 Too Many Requests su Retry-After antrašte.

Bazinis URL

https://d1arena.com/api/v1

Visi galiniai taškai grąžina JSON. Puslapiais suskaidyti galiniai taškai apima objektą meta su current_page, last_page ir total.

Srautai

GET /streams

Išvardykite šiuo metu vykstančius tiesioginius srautus. Palaiko puslapių ir kategorijų filtravimą.

Parametras	Tipas	Aprašymas
`category_id`	integer	Filtruoti pagal žaidimo / kategorijos ID
`limit`	integer	Rezultatai puslapyje (numatytasis: 20)
`page`	integer	Puslapio numeris

Atsakymas

{
  "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}

Gaukite vieno srautinio transliuotojo tiesioginę būseną ir informaciją apie srautą pagal naudotojo vardą arba šliužas.

Atsakymas

{
  "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"
  }
}

Kategorijos

GET /categories

Išvardykite visas žaidimų kategorijas. Palaiko paiešką ir puslapių rūšiavimą.

Parametras	Tipas	Aprašymas
`search`	string	Filtruokite kategorijas pagal pavadinimą
`limit`	integer	Rezultatai puslapyje (numatytasis: 50)

Atsakymas

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

Vartotojai

GET /users/{slug}

Gaukite viešą žaidėjo profilį ir konkurencinę statistiką pagal naudotojo vardą arba šliužas.

Atsakymas

{
  "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
    }
  }
}

Klipai

GET /clips

Išvardykite viešus klipus. Palaiko filtravimą pagal transliuotoją ir kategoriją.

Parametras	Tipas	Aprašymas
`streamer_id`	integer	Filtruokite klipus pagal srautinio perdavimo naudotojo ID
`category_id`	integer	Filtruoti pagal žaidimo / kategorijos ID
`limit`	integer	Rezultatai puslapyje (numatytasis: 20)

Atsakymas

{
  "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}

Gaukite vieno klipo detales.

Atsakymas

{
  "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" }
  }
}

Turnyrai

GET /tournaments

Turnyrų sąrašas. Palaiko filtravimą pagal būseną ir lygą.

Parametras	Tipas	Aprašymas
`status`	string	Filtruoti pagal būseną (pvz., `open`, `in_progress`, `completed`)
`league_id`	integer	Filtruoti pagal lygos ID
`limit`	integer	Rezultatai puslapyje (numatytasis: 20)

Atsakymas

{
  "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}

Gaukite informaciją apie turnyrą ir dalyvių skaičių.

Atsakymas

{
  "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 reitingai

GET /elo/leaderboard

Gaukite ELO reitingo lyderių lentelę. Pasirinktinai filtruokite pagal žaidimo kategoriją.

Parametras	Tipas	Aprašymas
`category_id`	integer	Filtruoti pagal žaidimo / kategorijos ID
`limit`	integer	Rezultatų skaičius (numatytasis: 50)

Atsakymas

{
  "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 }
}

Lygos

GET /leagues

Išvardykite lygas su pasirenkamais būsenos ir kategorijų filtrais.

Parametras	Tipas	Aprašymas
`status`	string	Filtruoti pagal lygos būseną
`category_id`	integer	Filtruoti pagal žaidimo / kategorijos ID
`limit`	integer	Rezultatai puslapyje (numatytasis: 20)

Atsakymas

{
  "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

Gaukite lygos reitingą (žaidėjų reitingą pagal taškus).

Atsakymas

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

Klaidų atsakymai

Visos klaidos grąžina nuoseklų JSON voką. Objekte error visada yra mašininiu būdu nuskaitomas code ir žmogaus skaitomas message.

Atsakymo į klaidą formatas

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

Patvirtinimo klaidos formatas (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."]
    }
  }
}

Būsenos kodai

200

Gerai — Prašymas pavyko. Atsakyme nurodyti prašomi duomenys.

400

Blogas prašymas — Užklausa netinkamai suformuota arba trūksta būtinų parametrų. Išsamesnės informacijos ieškokite error.message.

401

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

403

Draudžiama — Jūsų API raktas buvo išjungtas arba jam trūksta leidimo naudoti šį šaltinį. Patikrinkite savo Kūrėjo nustatymai.

404

Nerasta — Prašomas šaltinis neegzistuoja. Patikrinkite šliužo, ID arba galutinio taško kelią.

422

Patvirtinimo klaida — Nepavyko patvirtinti užklausos parametrų. Objektas error.errors susieja laukų pavadinimus su konkrečiomis problemomis.

429

Kaina ribota — Per daug prašymų. Antraštė Retry-After nurodo, kiek sekundžių reikia laukti prieš bandant dar kartą.

500

Serverio klaida — Mūsų pusėje įvyko netikėta klaida. Jei tai tęsis, susisiekite su palaikymo komanda.

Klaidų kodų nuoroda

Kodas	HTTP būsena	Aprašymas
`invalid_api_key`	401	Trūksta API rakto, jis netinkamai suformuotas arba jo nėra
`api_key_disabled`	403	API raktas buvo atšauktas arba išjungtas
`not_found`	404	Nepavyko rasti prašomo šaltinio
`validation_error`	422	Vienas ar daugiau užklausos parametrų neteisingi
`rate_limited`	429	Viršytas šio API rakto užklausų dažnumo limitas
`server_error`	500	Vidinė serverio klaida – bandykite dar kartą arba susisiekite su palaikymo tarnyba

Kainos ribos

API užklausos yra ribojamos pagal API raktą. Kai viršijate limitą, užklausos grąžina 429 Too Many Requests su Retry-After antrašte.

Ribos pagal pakopą

Pakopa	Prašymai / Minutė (Numatytoji)	Max Keys
Starteris (nemokamai)	60	5
PRO	60	5
Galutinis	60	5
Partneris	60	5

Kainos ribos antraštės

API užklausos yra ribojamos pagal API raktą. Kai viršijate limitą, užklausos grąžina 429 Too Many Requests su Retry-After antrašte.

Antraštė	Aprašymas
`Retry-After`	Sekundės, kurias reikia palaukti prieš bandant dar kartą (yra tik 429 atsakymuose)

Geriausia praktika

Patarimai, kaip laikytis ribų:

Cache responses locally — stream and tournament data doesn't change every second.
Prenumeruokite webhooks, kad gautumėte įvykius realiuoju laiku, o ne apklausos galutinius taškus.
Kai įmanoma, paketinės užklausos – naudokite filtro parametrus, kad gautumėte būtent tai, ko jums reikia per mažiau skambučių.

Webhooks (EventSub)

Užsisakykite tiesioginius pranešimus realiuoju laiku, o ne apklausą. Kai įvyksta įvykis, D1Arena siunčia HTTP POST į jūsų atgalinio skambučio URL su JSON naudingu kroviniu, pasirašytu HMAC-SHA256.

Sąranka

Sukurkite „Webhook“ prenumeratas naudodami Kūrėjo nustatymai. Kiekvienai prenumeratai reikia:

Atgalinio skambinimo URL — Viešai pasiekiamas HTTPS galutinis taškas jūsų serveryje.
Renginiai — Reikia užsiprenumeruoti vieną ar daugiau įvykių tipų.

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

Naudingos apkrovos formatas

Kiekvienas „Webhook“ pristatymas siunčia JSON turinį su tokia struktūra:

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

Antraštės

Kiekviename pristatyme yra šios antraštės, skirtos nukreipti ir patikrinti:

Antraštė	Aprašymas
`Content-Type`	`application/json`
`X-D1Arena-Event`	Įvykio tipas (pvz., `stream.online`)
`X-D1Arena-Signature`	HMAC-SHA256 šešioliktainė neapdorotos užklausos turinio santrauka
`X-D1Arena-Signature-Version`	Pasirašymo rakto formatas: `v2` dabartinėms prenumeratoms arba `v1-hashed-secret` senoms prenumeratoms
`X-D1Arena-Delivery-Id`	Unikalus pristatymo UUID – naudokite dubliavimui pašalinti
`X-D1Arena-Timestamp`	Unix laiko žyma, kada buvo išsiųstas įvykis

Parašų tikrinimas

Visada patikrinkite X-D1Arena-Signature antraštę prieš apdorodami „webhook“. Parašas apskaičiuojamas kaip HMAC-SHA256(raw_body, webhook_secret).

Pristatymams v2 naudokite whsec_ paslaptį, rodomą sukūrus prenumeratą. Jei norite gauti išankstinį naujinimą v1-hashed-secret, pirmiausia apskaičiuokite SHA256(whsec_secret) iš tos pradinės paslapties ir naudokite gautą šešioliktainę santrauką mažosiomis raidėmis kaip HMAC raktą. Jei įmanoma, iš naujo sukurkite prenumeratą, kad pereitumėte prie v2.

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)

Galimi įvykiai

Renginys	Aprašymas
stream.online	Srautinis transliuotojas pradėjo tiesiogiai
stream.offline	Srautinė transliuotoja atsijungė
channel.follow	Naudotojas sekė kanalą
channel.subscribe	Nauja rėmėjo prenumerata kanale
channel.tip	Srautininkui buvo išsiųstas patarimas
tournament.started	Turnyro rungtynės prasidėjo
tournament.ended	Baigėsi turnyras
tournament.match.completed	Buvo užfiksuotas rungtynių rezultatas
clip.created	Iš tiesioginės transliacijos buvo sukurtas naujas klipas
overdrive.started	D1 Frenzy prasidėjo kanale
overdrive.level_up	D1 Frenzy pakilo į kitą lygį
overdrive.ended	D1 Frenzy baigtas arba pasibaigęs

Renginio naudingos apkrovos pavyzdžiai

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
  }
}

Pristatymo ir pakartotinio bandymo politika

Bandymas	Vėlavimas	Pastabos
1 (pradinis)	Nedelsiant	Išsiųsta per kelias sekundes nuo įvykio
2 (bandyti dar kartą)	30 sekundžių	Jei pirmasis bandymas nepavyksta arba pasibaigia laikas
3 (bandyti dar kartą)	2 minutes	Eksponentinis atsitraukimas
4 (finalinis)	10 minučių	Paskutinis bandymas prieš pažymint kaip nepavykusį

Important: Your endpoint must respond with a 2xx status within 10 sekundžių. Non-2xx responses or timeouts trigger a retry. After 10 gedimų iš eilės, the subscription is automatically disabled. You'll receive an email notification and can re-enable it in Kūrėjo nustatymai.

Geriausia praktika

Visada patikrinkite parašus prieš apdorojant naudingus krovinius, kad būtų išvengta suklastotų įvykių.
Norėdami panaikinti dubliavimą, naudokite pristatymo ID — Bandymai pakartotinai siųsti tą patį ID, todėl saugokite apdorotus ID, kad išvengtumėte dvigubo apdorojimo.
Greitai atsakykite, apdorokite asinchroniškai — nedelsdami grąžinkite 200 OK ir tvarkykite verslo logiką fone.
Naudokite tik HTTPS galinius taškus — „Webhook“ URL turi naudoti TLS. HTTP atgaliniai skambučiai atmetami.
Grakščiai tvarkykite nežinomus įvykius — gali būti pridėta naujų įvykių tipų. Grąžinkite 200 už neatpažintus įvykius, o ne klaidą.

D1 Frenzy

„D1 Frenzy“ suaktyvina greiti patarimai ir prenumeratos, kol transliuotojas veikia tiesiogiai. Jis progresuoja per 5 lygius su didėjančiais tikslais.

GET `/api/overdrive/{streamerId}`

Gaukite aktyvųjį „D1 Frenzy“, skirtą streameriui. Grąžina {"active": false}, jei jo nėra.

{
  "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"
}

Tiksliniai lygiai

Lygis	Taškai
1	100
2	250
3	500
4	1,000
5	2,000

D1 Frenzy — Taškai: Patarimas $1 → 100; Prenumerata 500 × Pakopa. Trukmė: 5 Minutės; Atšalimas: 30 Minutės.

Plėtinio SDK

Sukurkite tinkintus skydelio ir perdangos plėtinius, kuriuos transliuotojai gali įdiegti savo kanalų puslapiuose. Plėtiniai veikia smėlio dėžės „iframe“ ir palaiko ryšį su pagrindiniu puslapiu per postMessage.

Darbo pradžia

Sukurkite API raktą Kūrėjo nustatymai.
Sukurkite plėtinį kaip atskirą HTML puslapį, priglobtą jūsų domene (reikalingas HTTPS).
Pateikite jį peržiūrėti skiltyje Mano plėtiniai.
Patvirtinus, transliuotojai gali jį įdiegti iš plėtinių prekyvietės.

Pratęsimo tipai

Tipas	Vieta	Elgesys
`panel`	Po srauto grotuvu	Matoma, kai srautas vyksta tiesiogiai. Viso pločio kortelė, numatytasis 300 pikselių aukštis.
`overlay`	Per vaizdo grotuvą	Matoma gyvai. Padėtį / dydį valdo streameris per perdangos padėties nustatymo įrankį.

postMessage API

Jūsų plėtinys automatiškai gauna kontekstinius duomenis, kai jis įkeliamas. Įgyvendinkite šiuos įvykius:

Kiekvienam pranešimui naudokite tikslią D1Arena pirminę kilmę. Oficialus SDK išveda ir patvirtina šią kilmę iš įterpimo puslapio automatiškai.

Kadangi plėtiniai iframe tyčia naudoja nepermatomą smėlio dėžės kilmę, D1Arena priegloba autentifikuoja tikslų registruotą iframe langą. Prieš priimdamas kontekstą, plėtinio kodas vis tiek turi autentifikuoti pirminį langą ir tikslią D1Arena kilmę.

1. Signalo parengtis

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

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

2. Gauti kontekstą

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. Siųsti veiksmus (neprivaloma)

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

Leidimų apimtys

Nurodykite, kokių duomenų reikia plėtiniui. Tikrintojai patikrina, ar jūsų kodas atitinka deklaruotus leidimus.

Taikymo sritis	Suteikia prieigą prie
`read:stream`	Srauto būsena, pavadinimas, kategorija
`read:viewers`	Žiūrovų skaičius ir sąrašas
`read:chat`	Pokalbių pranešimai (per „Pusher“ kanalą)
`read:clips`	Kanalo klipai per `/api/clips/{slug}`
`read:tournaments`	Aktyvi rungtynių informacija per `/api/active-match/{id}`
`read:channel`	Kanalo profilis, sekėjai, tvarkaraštis

Saugumo reikalavimai

Plėtiniai veikia smėlio dėžės „iframe“. su sandbox="allow-scripts". Jūsų plėtinys negali pasiekia slapukus, vietinę saugyklą arba pateikia autentifikuotas užklausas adresu d1arena.com.

Reikalingas viešas HTTPS — Jūsų „iframe“ URL turi naudoti TLS ir nurodyti tik viešojo tinklo adresus.
Žmonėms skaitomas šaltinis — Jokio užmaskuoto arba tik sumažinto JavaScript. Recenzentai turi turėti galimybę perskaityti jūsų kodą.
Išorinis scenarijus neįkeliamas nebent tai nurodyta jūsų pareiškime. CDN bibliotekos (jQuery, Chart.js ir kt.) yra tinkamos.
Jokio duomenų išfiltravimo — Plėtiniai neturi siųsti žiūrinčiųjų duomenų į trečiosios šalies analizės ar stebėjimo paslaugas.
Turinio politika — Jokių skelbimų, NSFW turinio, kriptovaliutų kasimo ar kenkėjiško elgesio.

Peržiūros procesas

Būsena	Reikšmė
pending	Pateikta, laukiama administratoriaus peržiūros (paprastai 1–3 darbo dienos).
approved	Patvirtinta ir matoma plėtinių prekyvietėje.
rejected	Atmesta su priežastimi. Išspręskite problemas ir pateikite iš naujo.
suspended	Laikinai pašalintas dėl politikos pažeidimo. Susisiekite su palaikymo komanda.

Versijų atnaujinimai

Norėdami atnaujinti patvirtintą plėtinį, ištrinkite dabartinę versiją ir pateikite naują su padidintu versijos numeriu. Naujoji versija vėl peržiūrima.

Pakeitimų žurnalas

Stebėkite API pakeitimus ir naujas funkcijas. Stebime semantines versijas ir pranešame apie lūžtančius pakeitimus bent prieš 30 dienų.

v1.02026 m. kovo mėn

Pradinis viešas API leidimas su API rakto autentifikavimu.
Srautai: pateikite tiesioginių srautų sąrašą ir gaukite informaciją apie srautinį perdavimą pagal šliužas.
Kategorijos: ieškokite ir išvardykite visas žaidimų kategorijas.
Naudotojai: vieši profiliai su konkurencine statistika, ELO įvertinimu ir medalių skaičiumi.
Klipai: naršykite ir gaukite išsamią klipo informaciją naudodami srautinio perdavimo / kūrėjo informaciją.
Turnyrai: sudarykite sąrašą, filtruokite pagal būseną / lygą, gaukite dalyvių skaičių.
ELO pirmaujančiųjų sąrašas: pasauliniai ir pagal kategorijas reitinguojami pirmaujančiųjų sąrašai.
Lygos: išvardykite lygas su turnyrinėmis lentelėmis ir taškų suskirstymu.
D1 Frenzy: bet kurio transliuotojo „Frenzy“ būsena realiuoju laiku.
Webhooks (EventSub): 12 įvykių tipų, įskaitant srautą, kanalą, turnyrą, klipą ir Frenzy įvykius.
Kainos ribos

Reikia pagalbos?

Turite klausimų apie API? Susisiekite su mumis.

Kūrėjo API

Kūrėjo API

Autentifikavimas

Bazinis URL

Srautai

Kategorijos

Vartotojai

Klipai

Turnyrai

ELO reitingai

Lygos

Klaidų atsakymai

Būsenos kodai

Klaidų kodų nuoroda

Kainos ribos

Ribos pagal pakopą

Kainos ribos antraštės

Geriausia praktika

Webhooks (EventSub)

Sąranka

Naudingos apkrovos formatas

Antraštės

Parašų tikrinimas

Galimi įvykiai

Renginio naudingos apkrovos pavyzdžiai

stream.online

stream.offline

channel.follow

channel.tip

tournament.match.completed

clip.created

Pristatymo ir pakartotinio bandymo politika

Geriausia praktika

D1 Frenzy

GET /api/overdrive/{streamerId}

Tiksliniai lygiai

Plėtinio SDK

Darbo pradžia

Pratęsimo tipai

postMessage API

1. Signalo parengtis

2. Gauti kontekstą

3. Siųsti veiksmus (neprivaloma)

Leidimų apimtys

Saugumo reikalavimai

Peržiūros procesas

Versijų atnaujinimai

Pakeitimų žurnalas

Reikia pagalbos?

GET `/api/overdrive/{streamerId}`