База знаний Waviot

API модуля telecom

ID статьи: 53
Последнее обновление: 22 Sep, 2021

API - методы модуля telecom

Модуль telecom выполняет функции NB-Fi телеком-cервера. Данный HTTP API-интерфейс позволяет получать, отправлять NB-Fi пакеты данных, конфигурировать режимы работы устройств, базовых станций, выполнять мониторинг работы сети и загружать лицензии на новые устройства.  Данные  API - методы доступны на сервере https://api.waviot.ru

Таблица 1. Сводная таблица всех API методов модуля telecom

Описание

URL

Метод

Чтение списка UL, DL, ULAPP, INFO пакетов

/telecom/api/messages

GET

Чтение списка DLAPP пакетов

/telecom/api/dl_messages

GET

Чтение статуса DLAPP пакета

/telecom/api/dl_message_status

GET

Отправка DLAPP пакета

/telecom/api/send_dl

GET

Удаление UL, DL, ULAPP, INFO пакета

/telecom/api/deletemessage

GET

Чтение параметров устройств

/telecom/api/device

GET

Конфигурирование параметров устройств

/telecom/api/device

POST

Чтение среднего уровня приема устройством UL пакетов

/telecom/api/devsnr

GET

Чтение параметров базовых станций

/telecom/api/bs

GET

Конфигурирование параметров базовых станций

/telecom/api/bs

POST

Чтение статистики БС

/telecom/api/stinfo

GET

Чтение общей статистики Telecom-сервера

/telecom/api/stats

GET

Загрузка лицензии на устройства

/telecom/api/license

POST

Чтение дополнительной статистики БС

/telecom/api/ststats

GET

Чтение истории БС

/telecom/api/sthistory

GET

Типы пакетов:
UL uniq - uplink пакет транспортного уровня протокола, имеющий длину всегда 8 байт.
UL copy - копия этого пакета, принятая другой базовой станцией(первый который пришел на сервер, это UL uniq, последующие  - UL copy)
У пакетов UL uniq и UL copy частота приема, SNR и RSSI соответствуют действительности.
ULAPP - это uplink пакет уровня приложения, который может иметь длину от 1 до 240 байт и может формироваться из одного либо нескольких пакетов UL uniq. У пакетов  ULAPP номер БС, частота приема SNR и RSSI определяются для  самой мощной копии UL пакета среди принятых разными БС. Так как ULAPP пакет формируется, непосредственно сразу после прихода не сервер первой копии UL пакета, то информация о самой мощной копии, имеется только по предыдущему UL пакету. По этой причине, данные в ULAPP пакетах различаются от данных в UL пакетах, из которых они сформированы.
DL - downlink пакет транспортного уровня, имеющий длину всегда 8 байт.
INFO - уведомления, сформированные сервером, не являющиеся передаваемыми пакетами.
Для получение UL uniq, UL copy, ULAPP, DL и INFO пакетов из базы данных, используется метод /telecom/api/messages 
DLAPP - это downlink пакет уровня приложения.
Для получение DLAPP пакетов из базы данных, используется метод /telecom/api/dl_messages

Чтение списка UL, DL, ULAPP, INFO пакетов

Чтение пакетов из базы данных с возможностью фильтрации по типу пакета, номерам устройств и/или БС и  времени приема(отправки) пакета.

GET запрос:

URL

Список параметров

Пример запроса

/telecom/api/messages

message_types, bs_ids, devices, timefrom, timeto, time_saved, limit

telecom/api/messages?message_types=3&devices=7769790&bs_ids=8249&timeto=1554991680&limit=400

Ответ:

BODY

[

    {

        "bs_id": 8249,

        "comment": "",

        "freq": 868812800,

        "iter": 35,

        "modem_id": 7769790,

        "payload": "420E245CAF1E3081890002382E8389000029978489000020A8816800000713",

        "phy": 26,

        "rssi": -75,

        "snr": 60,

        "time_detected": 1554990636,

        "time_saved": 1554990636,

        "type": 3

    },

    {

        "bs_id": 8249,

        "comment": "",

        "freq": 868813867,

        "iter": 222,

        "modem_id": 7769790,

        "payload": "EF121408",

        "phy": 26,

        "rssi": -74,

        "snr": 60,

        "time_detected": 1554990251,

        "time_saved": 1554990252,

        "type": 3

    }

]

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

message_types

int

тип пакета(1-UL uniq, 2- UL copy, 3 – ULAPP, 10 – DL, 20 - INFO)

3

bs_ids

int

номер(а) БС

все номера

devices

int

номера(а) устройств

все номера

timefrom

int

таймстамп времени начала данных

0

timeto

int

таймстамп времени окончания данных

текущее время

time_saved

int

0 – выборка по времени приема пакета

1 – выборка по времени сохранения пакета в БД

0

limit

int

ограничение количества пакетов

100

Чтение списка DLAPP пакетов

Чтение DLAPP пакетов из базы данных с возможностью фильтрации по статусу доставки пакета, номерам устройств и/или БС и  времени изменения статуса пакета.

GET запрос:

URL

Список параметров

Пример запроса

/telecom/api/dl_messages

statuses, bs_ids, devices, timefrom, timeto, limit

telecom/api/dl_messages?statuses=4&devices=7769790&bs_ids=8249&timeto=1554991680&limit=400

Ответ:

BODY

[

    {

        "bs_id": 8249,

        "modem_id": 7769790,

        "noise": -114,

        "payload": "EF121408",

        "phy": 3,

        "posted_time": 1554990250,

        "snr": 50,

        "status": 4,

        "tag_id": "drvElectro5_15939795"

    },

    {

        "bs_id": 8249,

        "modem_id": 7769790,

        "noise": -115,

        "payload": "EF0A",

        "phy": 3,

        "posted_time": 1554718939,

        "snr": 51,

        "status": 4,

        "tag_id": "drvElectro5_15579330"

    }

]

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

statuses

int

тип пакета(1-queued, 2- in process, 4 – delivered, 5 – lost)

1,2,4,5

bs_ids

int

номер(а) БС

все номера

devices

int

номера(а) устройств

все номера

timefrom

int

таймстамп времени начала данных

0

timeto

int

таймстамп времени окончания данных

текущее время

limit

int

ограничение количества пакетов

100

Отправка DLAPP-пакета

GET запрос:

URL

Список параметров

Пример запроса

/telecom/api/send_dl

modem_id, payload, tag_id

telecom/api/send_dl?modem_id=7607371&payload=deadbeaf

Ответ:

BODY

{
    "tag_id": "342519d9-9738-42f0-bd3d-1caddd15d3ca"
}

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

modem_id

int

номер устройства, на которое необходимо отправить DLAPP-пакет

обязательный параметр

payload

hex string

отправляемые данные в формате HEX

обязательный параметр

tag_id

string

тэг DLAPP-пакета

параметр может отсутствовать, в этом случае тэг будет сформирован автоматически

Чтение статуса DLAPP-пакета

GET запрос:

URL

Список параметров

Пример запроса

/telecom/api/dl_message_status

tag_id

telecom/api/dl_message_status?tag_id=342519d9-9738-42f0-bd3d-1caddd15d3ca

Ответ:

BODY

{
    "ACK": 1,
    "bs_id": 0,
    "modem_id": 7607371,
    "payload": "DEADBEAF",
    "phy": 0,
    "posted_time": 1555329074,
    "status": 5,
    "tag_id": "342519d9-9738-42f0-bd3d-1caddd15d3ca"
}

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

tag_id

int

тэг DLAPP-пакета

обязательный параметр

Удаление UL, DL, ULAPP пакета.

GET запрос:

URL

Список параметров

Пример запроса

/telecom/api/deletemessage

modem_id, type, station_id, iter, time_detected

telecom/api/deletemessage?modem_id=7769790&type=3&station_id=8249&iter=35&time_detected=1554990636

Ответ:

BODY

{
    "result": true
}

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

modem_id

int

номер устройства

обязательный параметр

type

int

тип пакета(1-UL uniq, 2- UL copy, 3 – ULAPP, 10 – DL, 20 - INFO)

обязательный параметр

station_id

int

номер БС

обязательный параметр

iter

int

поле iter пакета

обязательный параметр

time_detected

int

поле time_detected пакета

обязательный параметр

Чтение параметров устройств

GET запрос:

URL

Список параметров

Пример запроса

/telecom/api/device

dev_ids, total, list, type, protocol, mode,ul_phy,dl_phy, ul_lasttime_from, ul_lasttime_to, geolocation, limit, offset

telecom/api/device?dev_ids=8148928,8290056&geolocation=true

telecom/api/device?list=true&type=aqua2_stm&limit=32

telecom/api/device?total=true&dl_mode=DRX

Ответ на запрос без ключей list и total:

BODY

[

  {

    "bs_data": [

      {

        "aver_dl_nsnr": 18,

        "aver_dl_rssi": -120,

        "aver_rssi": -143.49600219726562,

        "aver_snr": 6,

        "bs_id": 9757,

        "f_offset": -170,

        "last_hb_ts": 1630103282,

        "last_success_dl_ts": 1604989771,

        "last_unsuccess_dl_ts": 1604942801,

        "rating": 400

      },

      {

        "aver_dl_nsnr": 0,

        "aver_dl_rssi": -120,

        "aver_rssi": -109.52223205566406,

        "aver_snr": 42,

        "bs_id": 10250,

        "f_offset": -273,

        "last_hb_ts": 1632298894,

        "last_success_dl_ts": -1,

        "last_unsuccess_dl_ts": -1,

        "rating": 100

      }

    ],

    "dl_base_freq": 446000000,

    "dl_bitrates": [

      0,

      1,

      2,

      3

    ],

    "dl_messages_per_ack": 1,

    "dl_mode": "OFF",

    "dl_num_of_retries": 3,

    "dl_phy": "DL_PSK_FASTDL",

    "dl_strength": 0,

    "freq_plan": 0,

    "geo_prec": 41232,

    "hw_type": "phobos3split_stm",

    "last_success_dl_ts": 1604989771,

    "last_unsuccess_dl_ts": 1604942801,

    "latitude": 53.705658,

    "longitude": 91.707151,

    "modem_id": 8148928,

    "nbfi_ver": 4,

    "pin": 61548,

    "protocol": "electro5",

    "rx_antenna": "PCB",

    "tx_antenna": "PCB",

    "ul_base_freq": 868775000,

    "ul_bitrates": [

      21,

      24,

      26

    ],

    "ul_lasttime": 1632298894,

    "ul_messages_per_ack": 1,

    "ul_phy": "UL_DBPSK_3200_PROT_D",

    "work_bs": 10250

  },

  {

    "bs_data": [

      {

        "aver_dl_nsnr": 41,

        "aver_dl_rssi": -91.53485107421875,

        "aver_rssi": -111.72696685791016,

        "aver_snr": 40,

        "bs_id": 10670,

        "f_offset": 324,

        "last_hb_ts": 1632298894,

        "last_success_dl_ts": 1632298894,

        "last_unsuccess_dl_ts": 1631669082,

        "rating": 600

      }

    ],

    "dl_base_freq": 446000000,

    "dl_bitrates": [

      0,

      1,

      2,

      3

    ],

    "dl_messages_per_ack": 1,

    "dl_mode": "CRX",

    "dl_num_of_retries": 3,

    "dl_phy": "DL_PSK_FASTDL",

    "dl_strength": 12,

    "freq_plan": 0,

    "geo_prec": 53146,

    "hw_type": "phobos1split_stm",

    "last_success_dl_ts": 1632298894,

    "last_unsuccess_dl_ts": 1631669082,

    "latitude": 56.36436,

    "longitude": 36.54644,

    "modem_id": 8290056,

    "nbfi_ver": 4,

    "pin": 27815,

    "protocol": "electro5",

    "rx_antenna": "PCB",

    "tx_antenna": "PCB",

    "ul_base_freq": 868775000,

    "ul_bitrates": [

      21,

      24,

      26

    ],

    "ul_lasttime": 1632298894,

    "ul_messages_per_ack": 1,

    "ul_phy": "UL_DBPSK_3200_PROT_D",

    "work_bs": 10670

  }

]

Ответ на запрос c ключом list=true:

BODY

{

  "modems": 32,

  "x_ids": [

    7559656,

    7564232,

    7559646,

    7575022,

    7558705,

    7564225,

    7564228,

    7575028,

    7559651,

    7575027,

    7580128,

    7584752,

    7564234,

    7575018,

    7559641,

    7564233,

    7558711,

    7564231,

    7583762,

    7584434,

    7564236,

    7575020,

    7564235,

    7575019,

    7575030,

    7580118,

    7575023,

    7582783,

    7558701,

    7952733,

    7564229,

    7940085

  ]

}

Ответ на запрос c ключом total=true:

BODY

{

  "modems": 73982

}

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

dev_ids

int

номер(а) устройств(а)

все номера

total

bool

true - вернуть результат в виде количества устройств

false

list

bool

true - вернуть результат в виде списка номеров

false

type

string

фильтрация по hw_type id

все варианты

protocol

string

фильтрация по protocol id

все варианты

dl_mode

string

фильтрация по dl_mode (NRX, DRX, CRX, OFF)

все варианты

ul_phy

string

Фильтрация по ul_phy (например, UL_DBPSK_3200_PROT_E)

все варианты

dl_phy

string

Фильтрация по ul_phy (например, DL_DBPSK_3200_PROT_D)

все варианты

ul_lasttime_from

int

Фильтрация по времени последнего UL пакета от устройства(UTC timestamp from)

0

ul_lasttime_to

int

Фильтрация по времени последнего UL пакета от устройства(UTC timestamp to)

текущее время

geolocation

bool

Выполнять расчет местоположения устройств по данным от базовых станций

false

limit

int

ограничение по кол-ву выдаваемых результатов(должно быть кратно 32)

320*N(1)

offset

int

смещение возвращаемых результатов(должно быть кратно 32)

0

  1. N – коэффициент масштабирования, зависит от конфигурации серверного ПО, может принимать значения от 1 до 32.

Конфигурирование параметров устройств

POST запрос:

URL

Список параметров

Пример запроса

/telecom/api/device

telecom/api/device

BODY

[

    {

        "modem_id": 8324098,

        "nbfi_ver": 5,

        "hw_type": "phobosL_wa_stm",

        "protocol": "electro5",

        "dl_strength": 26,

        "ul_messages_per_ack": 1,

        "dl_messages_per_ack": 1,

        "ul_base_freq": 868800000,

        "dl_base_freq": 869150000,

        "ul_bitrates": [30,31,32,33],

                  "dl_bitrates": [10,11,12,13],       

        "dl_mode": "CRX",

        "dl_num_of_retries": 132,

        "dl_strength": 0,

        "rx_antenna": "PCB",

        "tx_antenna": "PCB",

        "crypto_iter_ul": 67806,

        "crypto_iter_dl": 38912,

        "freq_plan": 45824,

        "ul_lasttime": 1631872000,

        "ul_phy": "UL_DBPSK_50_PROT_D",

        "dl_phy": "DL_DBPSK_25600_PROT_D",

    },

       {

        "modem_id": 8324099,

        "nbfi_ver": 5,

        "hw_type": "phobosL_wa_stm",

        "protocol": "electro5",

        "dl_strength": 26,

        "ul_messages_per_ack": 1,

        "dl_messages_per_ack": 1,

        "ul_base_freq": 868800000,

        "dl_base_freq": 869150000,

        "ul_bitrates": [30,31,32,33],

        "dl_bitrates": [10,11,12,13],       

        "dl_mode": "CRX",

        "dl_num_of_retries": 132,

        "dl_strength": 0,

        "rx_antenna": "PCB",

        "tx_antenna": "PCB",

        "crypto_iter_ul": 67806,

        "crypto_iter_dl": 38912,

        "freq_plan": 45824,

        "ul_lasttime": 1631872000,

        "ul_phy": "UL_DBPSK_50_PROT_D",

        "dl_phy": "DL_DBPSK_25600_PROT_D",

    }

]


В теле запроса должен быть массив(по кол-ву конфигурируемых устройств) структур, описывающих параметры устройства, которые необходимо изменить. В каждой структуре должен быть указан параметр modem_id и один либо более параметров, значение которых необходимо изменить.  

Чтение среднего уровня приема устройством UL пакетов

GET запрос:

URL

Список параметров

Пример запроса

/telecom/api/devsnr

dev_id

telecom/api/devsnr?dev_id=7769790

Ответ:

BODY

{
    "aver_nsnr": 77.05461120605469,
    "aver_rssi": -75.64028930664062,
    "total": 139
}

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

dev_id

int

номер(а) устройств(а)

обязательный параметр

Чтение параметров базовых станций.

GET запрос:

URL

Список параметров

Пример запроса

/telecom/api/bs

bs_ids, online_status, total, list, limit, offset

telecom/api/bs?bs_ids=10325,

telecom/api/bs?online_status=1&total=true,

telecom/api/bs?online_status=2&list=true&limit=10&offset=20

Ответ на запрос без ключей list и total:

BODY

[

  {

    "address": "г. Кемь",

    "bs_id": 10325,

    "bs_state": 15,

    "bs_type": "BS3",

    "comment": "",

    "dl_aver_busyness": 67,

    "dl_base_freqs": [

      "446000000",

      "864000000",

      "869150000"

    ],

    "dl_bitrates": [

      "DL_PSK_200",

      "DL_PSK_500",

      "DL_PSK_5000",

      "DL_PSK_FASTDL",

      "DL_DBPSK_50_PROT_D",

      "DL_DBPSK_400_PROT_D",

      "DL_DBPSK_3200_PROT_D",

      "DL_DBPSK_25600_PROT_D",

      "DL_DBPSK_50_PROT_D",

      "DL_DBPSK_400_PROT_D",

      "DL_DBPSK_3200_PROT_D",

      "DL_DBPSK_25600_PROT_D"

    ],

    "dl_foreigh_access": 1,

    "dl_status": 1,

    "fpga_temperature": 59,

    "gps_lasttime": 1632306472,

    "hw_rev": "",

    "last_hb_time": 1632306472,

    "latitude": 64.965872,

    "longitude": 34.697324,

    "mode": "BS",

    "noise": -146,

    "online_status": 1,

    "rev_list": [

      "751",

      "3.1.5",

      "ax.100"

    ],

    "status_duration": 95069,

    "temperature": 45,

    "timezone": "Europe/Moscow",

    "timezone_offset": 10800,

    "ul_base_freqs": [

      "868800000"

    ],

    "ul_bitrates": [

      "UL_DBPSK_50_PROT_C",

      "UL_DBPSK_400_PROT_C",

      "UL_DBPSK_50_PROT_D",

      "UL_DBPSK_400_PROT_D",

      "UL_DBPSK_3200_PROT_D",

      "UL_DBPSK_25600_PROT_D",

      "UL_DBPSK_50_PROT_E",

      "UL_DBPSK_400_PROT_E",

      "UL_DBPSK_3200_PROT_E",

      "UL_DBPSK_25600_PROT_E"

    ],

    "ul_foreigh_access": 1

  }

]

Ответ на запрос с ключом list=true:

BODY

{

  "stations": 10,

  "x_ids": [

    1208,

    1209,

    1210,

    1211,

    1212,

    1213,

    1214,

    1215,

    1216,

    1217

  ]

}

Ответ на запрос с ключом total=true:

BODY

{

  "stations": 517

}

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

bs_ids

int

номер(а) БС

все номера

online_status

int

статус БС(0 – все, 1 – онлайн, 2 - оффлайн)

0

total

bool

true - вернуть результат в виде количества устройств

false

list

bool

true - вернуть результат в виде списка номеров

false

limit

int

ограничение по кол-ву выдаваемых результатов

1000

offset

int

смещение возвращаемых результатов

0

Конфигурирование параметров базовых станций

POST запрос:

URL

Список параметров

Пример запроса

/telecom/api/bs

telecom/api/bs

BODY

[
    {
        "bs_id": 9500,
        "address": "г. МоскваЛесная 3",
        "comment": "BS3 v3.4",
        "latitude": 0,
        "longitude": 0,
        "timezone": "Europe/Moscow",
        "timezone_offset": 10800
    }
]

Чтение статистики базовой станции

GET запрос:

URL

Список параметров

Пример запроса

/telecom/api/stinfo

bs_ids, hours, dev_ids, snr, max_uls, type, protocol

telecom/api/stinfo?bs_ids=9500&protocol=water5

Ответ:

BODY

{
    "BS_Total": {
        "attached": {
            "AQUA2": 3,
            "DL_PSK_200": {
                "aver_nsnr": 53.54999923706055,
                "modems": 8
            },
            "KARAT": 3,
            "Neptun": 1,
            "NeroWaterMeter": 1,
            "UL_DBPSK_50_PROT_D": {
                "aver_nsnr": 53.54999923706055,
                "modems": 8,
                "uniq_uplinks": 19
            },
            "aver_message_rate": 2.375,
            "aver_nsnr": 53.54999923706055,
            "aver_snr": 53.54999923706055,
            "modems": 8,
            "stations": {
                "9500": 15,
                "stations": [
                    9500
                ]
            },
            "total_uplinks": 115133,
            "uniq_uplinks": 19,
            "x_ids": [
                7395129,
                7433238,
                7454102,
                7504761,
                7565846,
                7571070,
                7697503,
                7850754
            ]
        },
        "filtered": {
            "aver_nsnr": 41.86799621582031,
            "friend_stations": {
                "8228": 16,
                "9322": 7,
                "stations": [
                    8228,
                    9322
                ]
            },
            "modems": 23,
            "x_ids": [
                7414784,
                7421518,
                7421519,
                7421520,
                7435071,
                7437328,
                7520047,
                7520059,
                7520379,
                7558494,
                7560440,
                7561564,
                7581110,
                7581646,
                7584095,
                7585312,
                7697504,
                7722279,
                7780076,
                7851224,
                7851945,
                7851949,
                7851950
            ]
        }
    }
}

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

bs_ids

int

номер(а) БС

все номера

hours

int

период выгрузки статистики(кол-во последних часов)

24

dev_ids

int

фильтрация по номерам устройств

все номера

snr

int

порог уровня SNR(устройства с уровнем ниже данного порога попадают в список “low_snr_list”)

6

max_uls

int

порог кол-ва UL пакетов (устройства с кол-вом пакетов больше данного порога попадают в список “high_message_rate_list”)

type

string

фильтрация по типу(type) устройства

все типы

protocol

string

фильтрация по протоколу(protocol) устройства

все протоколы

Чтение общей статистики telecom-сервера

GET запрос:

URL

Список параметров

Пример запроса

/telecom/api/stats

telecom/api/stats

Ответ:

BODY

{
    "TelecomVersion": "2.2.14",
    "bsOnline": 432,
    "dlAppMessLast24Hour": 219394,
    "dlAppMessLastHour": 11241,
    "dlMessLast24Hour": 3021925,
    "dlMessLastHour": 149975,
    "dlMessPerSec": 31.783333333333335,
    "modemsLast24Hour": 148590,
    "modemsLastHour": 71411,
    "runnedTime": "days: 3 hours: 4 minutes: 36 sconds: 30",
    "successRateOfDlAppDelivery": 68.3569107055664,
    "successRateOfDlAppDelivery_daily": 65.7647933959961,
    "ulAppMessLast24Hour": 2195185,
    "ulAppMessLastHour": 89194,
    "ulAppMessPerSec": 13.75,
    "ulMessLast24Hour": 23134335,
    "ulMessLastHour": 853664,
    "ulMessPerSec": 148.31666666666666
}

Загрузка лицензии на устройства

POST запрос:

URL

Список параметров

Пример запроса

/telecom/api/license

telecom/api/license

BODY

<your license file>

Ответ:

BODY

{
  "result": true
}

Чтение дополнительной статистики БС.

GET запрос:

URL

Список параметров

Пример запроса

/telecom/api/ststats

bs_ids,  timefrom, timeto,  period, limit

telecom/api/ststats?bs_ids=8800&timeto=1585318469&period=60&imit=2

Ответ:

BODY

[
    {
        "aver_noise": -140,
        "bs_id": 8800,
        "dl_aver_power": 23,
        "dl_modems_total": 2,
        "dl_total": 3,
        "period": 60,
        "ts": 1585318469,
        "ts_ms": 1585318469,
        "ul_aver_rssi": -98,
        "ul_modems_total": 3,
        "ul_total": 4
    },
    {
        "aver_noise": -141,
        "bs_id": 8800,
        "dl_aver_power": 0,
        "dl_modems_total": 0,
        "dl_total": 0,
        "period": 60,
        "ts": 1585558051,
        "ts_ms": 1585558051,
        "ul_aver_rssi": -128,
        "ul_modems_total": 3,
        "ul_total": 3
    }
]

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

bs_ids

int

номер(а) БС

все номера

timefrom

int

таймстамп времени начала данных

0

timeto

int

таймстамп времени окончания данных

текущее время

limit

int

ограничение количества пакетов

100

period

int

Период статистики. Возможные значения: минутная (period=60), часовая (3600), суточная (86400).

0

Чтение истории БС.

GET запрос:

URL

Список параметров

Пример запроса

/telecom/api/sthistory

bs_ids,  timefrom, timeto,  limit

telecom/api/sthistory?bs_ids=9881,8980,9748&timefrom=1585560789&timeto=1585560827&limit=3

Ответ:

BODY

[
    {
        "bs_id": 8980,
        "bs_state": 15,
        "dl_aver_busyness": 15,
        "dl_busyness": 16,
        "dl_status": 2,
        "fpga_temperature": 0,
        "gps_lasttime": 1585560,
        "gps_lasttime_mc": 1585560.954,
        "last_hb_time": 1585560790,
        "last_hb_time_ms": 1585560790,
        "latitude": 56.123119,
        "lbt": 0,
        "longitude": 40.103175,
        "max_duty_cycle": 0,
        "max_power": 0,
        "noise": -153,
        "temperature": 62
    },
    {
        "bs_id": 9748,
        "bs_state": 15,
        "dl_aver_busyness": 6,
        "dl_busyness": 0,
        "dl_status": 1,
        "fpga_temperature": 0,
        "last_hb_time": 1585560819,
        "last_hb_time_ms": 1585560819,
        "lbt": 0,
        "max_duty_cycle": 0,
        "max_power": 0,
        "noise": -150,
        "temperature": 58
    },
    {
        "bs_id": 9881,
        "bs_state": 15,
        "dl_aver_busyness": 2,
        "dl_busyness": 0,
        "dl_status": 1,
        "fpga_temperature": 0,
        "gps_lasttime": 1585560,
        "gps_lasttime_mc": 1585560.954,
        "last_hb_time": 1585560790,
        "last_hb_time_ms": 1585560790,
        "latitude": 55.722699,
        "lbt": 0,
        "longitude": 37.645947,
        "max_duty_cycle": 0,
        "max_power": 0,
        "noise": -142,
        "temperature": 45
    }
]

Описание параметров запроса 

Имя параметра

Тип

Описание

Значение по умолчанию

bs_ids

int

номер(а) БС

все номера

timefrom

int

таймстамп времени начала данных

0

timeto

int

таймстамп времени окончания данных

текущее время

limit

int

ограничение количества пакетов

100

Эта статья была:   Полезна | Не полезна
Сообщить об ошибке
ID статьи: 53
Последнее обновление: 22 Sep, 2021
Ревизия: 21
Просмотры: 343
Комментарии: 0