Network

In dieser Dokumentation wird beschrieben, wie Sie mit einem Echtzeitdatendienst arbeiten. Lesen Sie diese Dokumentation sorgfältig durch, um die Arbeit mit unserem Netzwerk zu verstehen.

Erste Verbindung:

Zuerst müssen Sie die IP-Adresse und den Port des Servers bestimmen, da es mehrere Server geben kann und einige Server sich trennen und eine Verbindung zu uns herstellen können, verwenden Sie die API v2-Methode getListSpotServers. Diese Methode gibt eine Liste der IP-Adressen und Ports der Server zurück, die für die Verbindung verwendet werden sollen.

Beachten Sie, dass die getListSpotServers-Methode die Anzahl der verbundenen Clients zurückgibt, und es wird empfohlen, dass Sie eine Verbindung mit dem Server herstellen, der die geringste Anzahl von Clients hat. Dieser Ansatz wird die Last gleichmäßig verteilen.

Sie können eine Verbindung mit einem TCP-Logger von Drittanbieter-Software herstellen oder einen Befehl im Terminal ausführen:

Terminal 
telnt {ip} {port}

Sobald Sie verbunden sind, werden Sie beginnen, Nachrichten im JSON-Format zu erhalten, dann werden wir über diese Nachrichten als Ereignisse sprechen. Im Folgenden finden Sie ein Beispiel für Spot-Ereignisse, welche Ereignisse vorhanden sind und wie sie behandelt werden, lesen Sie weiter.

Ereignisse:

Im Moment gibt es nur 3 Ereignisse, das ist: spot, message, sun. Alle Ereignisse, die über die getListSpotServers-Methode an Server gesendet werden, sind identisch. Dies dient dazu, sicherzustellen, dass Nachrichten, Spotts und andere Daten an alle Benutzer des Systems übermittelt werden. Unabhängig davon, mit welchem Server ein Benutzer verbunden ist, erhält er den vollständigen und gleichen Ereignissatz. Auf diese Weise wird sichergestellt, dass die Daten einheitlich sind und alle Clients in einer verteilten Umgebung synchron arbeiten.

Allgemeine JSON-Struktur einer Nachricht 
{
    "event": "name_event", // ENUM kann Werte sein: spot, message, sun
    "data": {...}, // Bitte lesen Sie die Beschreibung der Ereignisse.
    "event_at": "Y-m-d H:i:s" // Datum und Uhrzeit des: 2025-08-29 19:23:25-Ereignisses
}

Ereignis: message

Dieses Ereignis informiert Sie, wenn eine Chat-Nachricht gesendet wird. Dazu wird eine API-Anfrage an die sendMessage -Methode verwendet. Weitere Informationen zum Senden von Nachrichten finden Sie in der API v2-Dokumentation.

Eine Liste der Chats kann über die getChats -Methode abgerufen werden.

Ereignisdaten 
{
    "chat_id": 1,
    "sender": "R4CAT/P",
    "text_color": "#1E3A5F",
    "background_color": "#E6F0FA",
    "text": "Hallo! Ich bin gerade auf dem Feld, schicke jemanden mit Tee, es ist kalt hier."
}

Ergebnis:

R4CAT/P:
Hallo! Ich bin gerade auf dem Feld, schicke jemanden mit Tee, es ist kalt hier. 29.08.2025 19:23

Ereignis: sun

Sendet einen aktuellen Index der Sonnenaktivität, es ist nützlich zu verfolgen, um nicht auf die API des Dienstes zuzugreifen.

Ereignisdaten 
{
    "value": 4 // Ein kleiner geomagnetischer Sturm.
}
  1. 1 — Es gibt keine erkennbaren Störungen.
  2. 2 — Kleine Empörung.
  3. 3 — Ein schwacher geomagnetischer Sturm.
  4. 4 — Ein kleiner geomagnetischer Sturm.
  5. 5 — Mäßiger geomagnetischer Sturm.
  6. 6 — Starker geomagnetischer Sturm.
  7. 7 — Ein harter geomagnetischer Sturm.
  8. 8 — Ein extremer Sturm.