Network

Бұл құжаттама нақты уақыт режимінде деректерді беру қызметімен жұмысты сипаттайды. Біздің желімен жұмыс істеуді түсіну үшін осы құжаттаманы мұқият оқып шығыңыз.

Бірінші Байланыс:

Бастау үшін сервердің IP мекенжайы мен портын анықтау қажет, өйткені серверлер бірнеше болуы мүмкін және кейбір серверлер бізден ажыратылып, қосыла алады, getListSpotServers әдісімен V2 API пайдаланыңыз. Бұл әдіс қосылу үшін IP мекенжайларының тізімін және сервер порттарын қайтарады.

Назар аударыңыз, getlistspotservers әдісі қосылған клиенттердің санын қайтарады, біз сізге клиенттердің ең аз саны бар серверге қосылуға кеңес береміз. Бұл тәсіл жүктемені біркелкі таратады.

Сіз TCP Logger үшінші тарап бағдарламалық жасақтамасын пайдаланып немесе терминалда пәрменді орындау арқылы қосыла аласыз:

Terminal

telnt {ip} {port}

Қосылғаннан кейін сіз JSON форматында хабарламалар ала бастайсыз, содан кейін біз бұл хабарламалар туралы оқиғалар сияқты сөйлесеміз. Төменде spot оқиғаларының мысалы келтірілген, қандай оқиғалар бар және оларды қалай өңдеу керек.

Оқиғалар:

Қазіргі уақытта тек 3 оқиғалар бар, бұл: spot, message, sun. Getlistspotservers әдісінен серверлерде таратылатын барлық оқиғалар бірдей. Бұл жүйенің барлық пайдаланушыларына хабарламаларды, дақтарды және кез келген басқа деректерді жеткізуді қамтамасыз ету үшін. Пайдаланушы қандай нақты серверге қосылғанына қарамастан, ол оқиғалардың толық және бірдей жиынтығын алады. Осылайша, таратылған ортадағы барлық клиенттердің деректерінің біркелкілігі мен синхрондылығы қамтамасыз етіледі.

JSON хабарламасының жалпы құрылымы

{
    "event": "name_event", // ENUM мәндері болуы мүмкін: spot, message, sun
    "data": {...}, // Данне оқиғалары, оқиғалардың сипаттамасын оқыңыз.
    "event_at": "Y-m-d H:i:s" // Оқиға күні мен уақыты: 2025-08-29 19:23:15
}

Оқиға: {оқиға}

Бұл оқиға чатта хабарлама жіберу туралы хабарлайды. Ол үшін sendMessage әдісіне API сұранысы қолданылады. Хабарлама жіберу жұмысы туралы мәліметтерді V2 API құжаттамасынан қараңыз.

Чаттар тізімін getChats әдісі арқылы алуға болады.

Деректер оқиғалары

{
    "chat_id": 1,
    "sender": "R4CAT/P",
    "text_color": "#1E3A5F",
    "background_color": "#E6F0FA",
    "text": "Сәлем! Мен қазір далада тұрмын, біреуді шаймен жіберіңіз, мұнда суық."
}

Нәтижесі:

R4CAT/P:
Сәлем! Мен қазір далада тұрмын, біреуді шаймен жіберіңіз, мұнда суық. 29.08.2025 19:23

Оқиға: {оқиға}

Күн белсенділігінің өзекті индексін жібереді, қызметтің API-ге жүгінбеу үшін бақылау пайдалы.

Деректер оқиғалары

{
    "value": 4 // Шағын геомагниттік дауыл.
}

1 — Ешқандай наразылық байқалмайды.
2 — Кішкентай толқулар.
3 — Әлсіз геомагниттік дауыл.
4 — Шағын геомагниттік дауыл.
5 — Орташа геомагниттік дауыл.
6 — Күшті геомагниттік дауыл.
7 — Қатты геомагниттік дауыл.
8 — Қатты дауыл.