Network

Әлеге документлар мәгълүматларны тапшыру сервисы белән реаль вакыт режимында эшләүне тасвирлый. Безнең челтәр белән эшләүне аңлау өчен, әлеге документацияне игътибар белән укыгыз.

Беренче тоташу:

Башта серверның IP адресын һәм портын билгеләү таләп ителә, чөнки серверлар бердән артык булырга мөмкин һәм ниндидер серверлар сүндерелергә һәм безнең белән тоташырга мөмкин, getListSpotServers методы белән Api v2 кулланыгыз. Әлеге ысул тоташтыру өчен серверларның 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 16:17:33
}

Вакыйга: message

Әлеге вакыйга чатта хәбәр җибәрү турында хәбәр итә. Моның өчен sendMessage методына API-сорау кулланыла. Хәбәрләр җибәрү белән эшләү турында тулырак API v2 документациясендә карагыз.

Чатлар исемлеген getChats ысулы аша алырга мөмкин.

Әлеге вакыйгалар

{
    "chat_id": 1,
    "sender": "R4CAT/P",
    "text_color": "#1E3A5F",
    "background_color": "#E6F0FA",
    "text": "Сәлам! Мин хәзер кырда, кемнедер чәй белән җибәрегез, монда салкын."
}

Нәтиҗә:

R4CAT/P:
Сәлам! Мин хәзер кырда, кемнедер чәй белән җибәрегез, монда салкын. 29.08.2025 16:17

Вакыйга: sun

Кояш активлыгының актуаль индексын җибәрә, сервисның API обращ мөрәҗәгать итмәс өчен күзәтеп тору файдалы.

Әлеге вакыйгалар

{
    "value": 4 // Кече геомагнит давылы.
}

1 — Сизелерлек ачу юк.
2 — Зур булмаган ачу.
3 — Зәгыйфь геомагнит давылы.
4 — Кече геомагнит давылы.
5 — Уртача геомагнит давыл.
6 — Көчле геомагнит давылы.
7 — Каты геомагнит шторм.
8 — Экстремаль шторм.