Network

Această documentație descrie modul de lucru cu un serviciu de transfer de date în timp real. Vă rugăm să citiți cu atenție această documentație pentru a înțelege cum să lucrați cu rețeaua noastră.

Prima conexiune:

Mai întâi, trebuie să determinați adresa IP și portul serverului. deoarece pot exista mai multe servere și unele servere pot fi deconectate și conectate de noi, utilizați metoda API V2 getListSpotServers. Această metodă va returna o listă de adrese IP și porturi de server la care să vă conectați.

Vă puteți conecta utilizând loggerul TCP al unui software terță parte sau executând o comandă în terminal.:

telnt {ip} {port}

După conectare, veți începe să primiți mesaje în format json, apoi vom vorbi despre aceste mesaje ca evenimente. Mai jos este un exemplu de evenimente spot, care Evenimente există și cum să le gestionați, citiți mai departe.

Evenimente:

În acest moment, există doar 3 evenimente, acestea sunt: spot, message, sun. Toate evenimentele care sunt difuzate către servere din metoda getListSpotServers sunt identice. Acest lucru se face pentru a asigura livrarea de mesaje, spoturi și orice alte date către toți utilizatorii sistemului. Indiferent de serverul specific la care este conectat utilizatorul, acesta va primi un set complet și identic de evenimente. Acest lucru asigură uniformitatea datelor și sincronicitatea tuturor clienților într-un mediu distribuit.

{
    "event": "name_event", // ENUM poate avea valori: spot, message, sun
    "data": {...}, // Având în vedere evenimentele, citiți descrierea evenimentelor.
    "event_at": "Y-m-d H:i:s" // Data și ora evenimentului: 2025-08-29 16:21:20
}

Eveniment: {eveniment}

Acest eveniment vă informează despre trimiterea unui mesaj în chat. O cerere API către metoda sendMessage este utilizată în acest scop. Pentru mai multe informații despre lucrul cu trimiterea mesajelor, consultați documentația API V2.

Puteți obține o listă de chat-uri folosind metoda getChats.

{
    "chat_id": 1,
    "sender": "R4CAT/P",
    "text_color": "#1E3A5F",
    "background_color": "#E6F0FA",
    "text": "Bună! Sunt pe teren chiar acum, trimite pe cineva cu ceai, e frig aici."
}

Rezultat:

Eveniment: {eveniment}

Trimite un indice actualizat al activității solare.este util să îl urmăriți astfel încât să nu accesați API-ul Serviciului.

{
    "value": 4 // Furtună geomagnetică mică.
}

1. 1 — Nu există tulburări vizibile.
2. 2 — Tulburări mici.
3. 3 — O furtună geomagnetică slabă.
4. 4 — Furtună geomagnetică mică.
5. 5 — Furtună geomagnetică moderată.
6. 6 — Furtună geomagnetică puternică.
7. 7 — O furtună geomagnetică severă.
8. 8 — O furtună extremă.