Network

Questa documentazione descrive come utilizzare il servizio dati in tempo reale. Leggere attentamente questa documentazione per comprendere il funzionamento della nostra rete.

Prima connessione:

Innanzitutto, è necessario determinare l'indirizzo IP del server e la porta, poiché possono esserci più di un server e alcuni server possono disconnettersi e connettersi da noi, utilizzare L'API v2 con il metodo getListSpotServers. Questo metodo restituirà un elenco di indirizzi IP e le porte dei server per la connessione.

Si noti che il metodo getListSpotServers restituisce il numero di client connessi, si consiglia di connettersi al server che ha il minor numero di client. Questo approccio distribuirà il carico in modo uniforme.

È possibile connettersi utilizzando TCP Logger software di terze parti o eseguendo un comando nel terminale:

Terminal 
telnt {ip} {port}

Dopo la connessione, si inizierà a ricevere i messaggi in formato json, poi parleremo di questi messaggi come eventi. Di seguito è riportato un esempio di eventi spot, quali eventi Ci sono e come gestirli.

Eventi:

Al momento ci sono solo 3 eventi, Questo è: spot, message, sun. Tutti gli eventi trasmessi ai server dal metodo getListSpotServers sono identici. Questo per garantire la consegna di messaggi, spot e qualsiasi altro dato a tutti gli utenti del sistema. Indipendentemente dal server specifico a cui l'utente è connesso, riceverà un insieme completo e identico di eventi. In questo modo, i dati sono coerenti e tutti i client sono sincronizzati in un ambiente distribuito.

Struttura generale del messaggio JSON 
{
    "event": "name_event", // ENUM può essere valori: spot, message, sun
    "data": {...}, // Date gli eventi, leggi la descrizione degli eventi.
    "event_at": "Y-m-d H:i:s" // Data e ora dell'evento: 2025-08-29 19:17:59
}

Evento: message

Questo evento informa l'invio di un messaggio di chat. A tale scopo viene utilizzata una richiesta API al metodo sendMessage. Per ulteriori informazioni sull'invio di messaggi, consultare la documentazione DELL'API V2.

L'elenco delle chat è accessibile tramite il metodo getChats.

Dati evento 
{
    "chat_id": 1,
    "sender": "R4CAT/P",
    "text_color": "#1E3A5F",
    "background_color": "#E6F0FA",
    "text": "Ciao! Ora sono nel campo, manda qualcuno con il tè, fa freddo."
}

Risultato:

R4CAT/P:
Ciao! Ora sono nel campo, manda qualcuno con il tè, fa freddo. 29.08.2025 19:17

Evento: sun

Invia l'attuale indice di attività solare, è utile tenere traccia di non contattare L'API del servizio.

Dati evento 
{
    "value": 4 // Piccola tempesta geomagnetica.
}
  1. 1 — Nessun disturbo evidente.
  2. 2 — Piccole perturbazioni.
  3. 3 — Una debole tempesta geomagnetica.
  4. 4 — Piccola tempesta geomagnetica.
  5. 5 — Tempesta geomagnetica moderata.
  6. 6 — Forte tempesta geomagnetica.
  7. 7 — Tempesta geomagnetica dura.
  8. 8 — Tempesta estrema.