Network

Tato dokumentace popisuje práci s datovou službou v reálném čase. Přečtěte si pozorně tuto dokumentaci, abyste pochopili práci s naší sítí.

První připojení:

Chcete-li začít, musíte určit IP adresu serveru a port, protože serverů může být více než jeden a některé servery se mohou odpojit a připojit se k nám, Použijte rozhraní API v2 metodou getListSpotServers. Tato metoda vrátí seznam IP adres a portů serverů pro připojení.

Všimněte si, že metoda getListSpotServers vrací počet připojených klientů, doporučujeme vám připojit se k serveru, který má nejmenší počet klientů. Tento přístup rozloží zátěž rovnoměrně.

Připojit se můžete pomocí TCP Logger softwaru třetí strany nebo spuštěním příkazu v terminálu:

Terminal 
telnt {ip} {port}

Jakmile se připojíte, začnete dostávat zprávy ve formátu json, dále budeme mluvit o těchto zprávách jako o událostech. Níže je uveden příklad událostí spot, jaké jsou události a jak je zpracovat čtěte dále.

Události:

V tuto chvíli existuje pouze 3 události, to je: spot, message, sun. Všechny události, které jsou vysílány na serverech z metody getlistspotservers, jsou identické. To je provedeno s cílem zaručit doručení zpráv, spotů a jakýchkoli dalších dat všem uživatelům systému. Bez ohledu na to, ke kterému konkrétnímu serveru je uživatel připojen, obdrží celou a stejnou sadu událostí. Tímto způsobem je zajištěna jednotnost dat a synchronizace práce všech zákazníků v distribuovaném prostředí.

Obecná struktura JSON zprávy 
{
    "event": "name_event", // ENUM mohou být hodnoty: spot, message, sun
    "data": {...}, // Přečtěte si popis událostí.
    "event_at": "Y-m-d H:i:s" // Datum a čas události: 2025-08-29 20:57:16
}

Událost: message

Tato událost informuje o odeslání zprávy v chatu. K tomu se používá API Dotaz k metodě sendMessage. Podrobnosti o práci s odesíláním zpráv naleznete v dokumentaci API v2.

Seznam chatů lze získat pomocí metody getChats.

Data události 
{
    "chat_id": 1,
    "sender": "R4CAT/P",
    "text_color": "#1E3A5F",
    "background_color": "#E6F0FA",
    "text": "Ahoj! Jsem na poli, pošlete někoho s čajem, je tu zima."
}

Výsledek:

R4CAT/P:
Ahoj! Jsem na poli, pošlete někoho s čajem, je tu zima. 29.08.2025 20:57

Událost: sun

Posílá aktuální index sluneční aktivity, je užitečné sledovat, co se týká API služby.

Data události 
{
    "value": 4 // Malá geomagnetická bouře.
}
  1. 1 — Žádné výrazné pobouření.
  2. 2 — Malé pobouření.
  3. 3 — Slabá geomagnetická bouře.
  4. 4 — Malá geomagnetická bouře.
  5. 5 — Mírná geomagnetická bouře.
  6. 6 — Silná geomagnetická bouře.
  7. 7 — Tvrdá geomagnetická bouře.
  8. 8 — Extrémní bouře.