Skorborð

Lifandi staða úr pílukastleikjum sem skráðir eru í DartConnect. Þið fáið JSON með stöðunni, nöfnum, útskotsleið og tölfræði leiksins, og getið keyrt ykkar eigin grafík á því. Ef það hentar betur er líka til tilbúin grafík sem fer beint inn í vMix eða OBS.

Að byrja

1. Finnið live-slóð spjaldsins í DartConnect. Hún lítur svona út:

   https://tv.dartconnect.com/live/myjyp/M/idafloridanana26r7

   Kóðinn er hlutinn á eftir /live/, hér myjyp. Það má líka senda alla slóðina, þjónustan finnur kóðann sjálf.

2. Notið lykilinn sem þið fenguð (sjá Lyklar).

3. Tengist /api/stream til að fá hverja breytingu um leið, eða spyrjið /api/state reglulega.

Lyklar

Öll köll þurfa lykil. Best er að senda hann í haus:

Authorization: Bearer LYKILL

Þar sem ekki er hægt að setja haus, t.d. í browser source, má setja hann í slóðina: ?key=LYKILL.

Án lykils, eða með röngum lykli, kemur 401. Hver aðili fær sinn eigin lykil og hægt er að loka einum án þess að það hafi áhrif á aðra.

/api/stream

GET/api/stream?code=myjyp

Straumur (Server-Sent Events). Í hvert sinn sem staðan breytist, eftir hverja umferð, kemur skilaboð af tegundinni board með allri stöðunni á gagnasniðinu:

event: board
data: {"version":1,"code":"myjyp","status":"live", … }

Þegar leik lýkur kemur auk þess, einu sinni, skilaboð af tegundinni finished með lokastöðunni. Fínt til að kalla fram lokagrafík:

event: finished
data: {"status":"finished","winner":0, … }

Lokastaðan stendur yfirleitt aðeins í nokkrar sekúndur á spjaldinu áður en það fer í idle, svo grípið hana úr straumnum frekar en með /api/state.

Á 15 sekúndna fresti kemur : ping til að halda tengingunni opinni. Straumurinn lokast af sjálfu sér eftir nokkrar mínútur. EventSource í vafra tengist þá strax aftur án þess að neitt þurfi að gera; í öðrum kerfum þarf að tengjast aftur þegar straumurinn endar.

/api/state

GET/api/state?code=myjyp

Staðan eins og hún er núna, eitt JSON-svar. Fyrir kerfi sem geta ekki tekið við straumi. Spyrjið á 1–2 sekúndna fresti.

Gagnasnið

Sama snið í báðum köllum. Þetta er útgáfa 1.

{
  "version": 1,
  "code": "myjyp",
  "updated": "2026-10-25T10:59:19.499Z",
  "status": "live",
  "winner": null,
  "match_id": "6adddea4bd32629b2fc61c94",
  "event":  { "tournament": "Floridana - NA deild 7. umferð 2026",
              "title": "Gulldeild NA - A og B", "round": "Round Robin" },
  "format": { "legs_first_to": 4, "sets": false, "description": "First to 4 Legs" },
  "leg":    { "number": 4, "starter": 1 },
  "throwing": 1,
  "players": [
    {
      "id": "ojr92owj",
      "key": "ojr92owj",
      "name": "Jón Oddur Hjálmtýsson",
      "display": "Jón Oddur",
      "country": "IS",
      "remaining": 117,
      "legs": 2,
      "sets": 0,
      "last_visit": 95,
      "darts_in_leg": 18,
      "average": { "match": 55.99, "leg": 64 },
      "checkout": ["T20", "17", "D20"],
      "checkout_standard": ["T20", "17", "D20"],
      "throwing": false,
      "stats": {
        "t180": 0, "t140": 1, "t100": 3,
        "highest_checkout": 86, "checkouts_100plus": 0,
        "best_leg_darts": 21, "first9_avg": 56.93,
        "legs_won": 4, "breaks": 2
      }
    },
    // seinni leikmaðurinn, sama snið
  ]
}

Leikurinn

Leikmenn

Tölfræði leiksins (stats)

Kemur úr leikskýrslu DartConnect og uppfærist eftir hvern legg. Er null þar til fyrsta skýrslan liggur fyrir.

Dæmi

curl

curl -H "Authorization: Bearer LYKILL" "https://SLOD/api/state?code=myjyp"

curl -N -H "Authorization: Bearer LYKILL" "https://SLOD/api/stream?code=myjyp"

Í HTML-grafík

const es = new EventSource("https://SLOD/api/stream?code=myjyp&key=LYKILL");

es.addEventListener("board", (e) => {
  const b = JSON.parse(e.data);
  if (b.status !== "live") return hide();
  const [a, c] = b.players;
  update(a, c, b.throwing);
});

Node.js

const res = await fetch("https://SLOD/api/stream?code=myjyp", {
  headers: { Authorization: "Bearer LYKILL" },
});
const reader = res.body.getReader();
const dec = new TextDecoder();
let buf = "";

while (true) {
  const { value, done } = await reader.read();
  if (done) break;                       // tengjast aftur hér
  buf += dec.decode(value, { stream: true });
  let i;
  while ((i = buf.indexOf("\n\n")) >= 0) {
    const msg = buf.slice(0, i);
    buf = buf.slice(i + 2);
    const data = msg.split("\n").find((l) => l.startsWith("data:"));
    if (msg.includes("event: board") && data) handle(JSON.parse(data.slice(5)));
  }
}

Tilbúin grafík

Ef þið viljið ekki smíða ykkar eigin: setjið þessa slóð inn sem browser source, 1920×1080. Bakgrunnurinn er gegnsær og borðið hverfur sjálft á milli leikja.

https://SLOD/grafik?code=myjyp&key=LYKILL

Tölfræði eftir þörfum

Tölfræðilínan kemur upp þegar ýtt er á takka og fer þegar ýtt er aftur. Í vMix má senda takka á browser source, í OBS þarf að smella á hana fyrst (Interact).

Gott að vita

• Gögnin eru jafn rétt og það sem ritarinn slær inn í DartConnect. Seinkunin er yfirleitt undir sekúndu.
• Einn kóði er eitt spjald. Ef fleiri leikir eru spilaðir á sama spjaldi skiptir straumurinn sjálfur yfir. Á milli leikja er status idle.
• Útskotsleiðirnar koma úr hefðbundinni útskotstöflu, þeirri sem atvinnumenn nota. Þegar andstæðingurinn er sjálfur á útskoti er sýnd leið sem endar á Bull, þar sem það er algengt val (t.d. 110: T20 Bull í stað T20 10 D20), því þá verður að reyna að klára í umferðinni. Hefðbundna leiðin er alltaf í checkout_standard.
• Sniðið breytist ekki nema version hækki. Ný svið geta bæst við, svo hunsið svið sem þið þekkið ekki.