API device UK

en | uk | ru

Розділ API ERP "UserSide"

Призначення: Обладнання

Додаткові параметри:
action - підкатегорія запиту (можливе значення: див. нижче)

Підкатегорії

add_mark

Змінено у 3.19beta1 (параметр object_type исключен)

Опис: Додавання мітки
Обов'язкові параметри:
 object_type - Тип пристрої [switch] (до версії 3.19beta1)
 object_id - id пристрої
 mark_id - ID мітки

get_connected_ont_information

Додано у: 3.14.13

Опис: Отримання информации о підключених ONU к OLT (сохраненная информация из бази. Прямой опрос не виконується)
Необов'язкові параметри:
 device_id - ID OLT (можна через кому)
 level_onu_rx_min - мінімальний входящий рівень сигнала на ONU (вибрати запису с уровнем менее чем...)
 level_onu_rx_max - максимальний входящий рівень сигнала на ONU (вибрати запису с уровнем вище чем...)

get_current_ont_data

Додано з: 3.16dev4

Опис: Отримання деякої поточної інформації по ONU з OLT
Обов'язкові параметри:
 id - id пристрої (ONU)

get_device_id

Змінено у 3.19beta1 (параметр object_type исключен)

Доопрацьовано у: 3.13.63 (в data_typer додано можливе значення serial_number)

Доопрацьовано у: 3.12.95 (в data_typer додано можливе значення mac)

Опис: Отримання ID пристрою за вхідними даними
Обов'язкові параметри:
 object_type - тип пристрою [switch] (до версії 3.19beta1)
 data_typer - тип даних, які перевіряємо (можливі значення: ip, mac, inventory_number, serial_number, additional_field_XXX)
 data_value - значення

get_data

Доопрацьовано у 3.20.2 (додано параметр is_with_ip)

Доопрацьовано у 3.19.15 (додано параметр customer_id)

Доопрацьовано у 3.19beta1 (додано параметр dataset)

Доопрацьовано у: 3.18.4 (додано параметр is_hide_access_data)

Доопрацьовано у: 3.17beta1 (додано параметр node_id)

Доопрацьовано у: 3.15.18 (добавлен object_type=olt)

Доопрацьовано у: 3.14.14 (додано параметр is_hide_ifaces_data)

Доопрацьовано у: 3.12.38 (добавлен object_type=all)

Опис: Отримання информации об пристроїх
Обов'язкові параметри:
 object_type - Тип пристрої [switch|onu|olt|radio|all]
Необов'язкові параметри:
 customer_id - id абонента (можна через кому)
 dataset - список полів, які виводити у видачі (через кому)
 is_online - прапорець - вибирати тільки активні пристрої (1 - активні, -1 - неактивні)
 is_hide_ifaces_data - прапорець - приховувати розгорнуту информацию по интерфейсам обладнання
 is_hide_access_data - прапорець - приховувати информацию по параметрам доступа к оборудованию
 is_with_ip - прапорець - тільки з IP-адресами
 node_id - id об'єкти інфраструктури (можна через кому)
 object_id - id об'єкта для вибірки

get_iface_info

Додано з: 3.17dev1

Опис: Отримання текущей информации по интерфейсам (напрямую с пристрої)
Обов'язкові параметри:
 id - id пристрої

get_iface_mac

Змінено у 3.19beta1 (параметр object_type исключен)

Додано з: 3.12beta25

Опис: Список интерфейсов с MAC-адресами на пристрої
Обов'язкові параметри:
 object_type - Тип пристрої [switch] (до версії 3.19beta1)
 object_id - id пристрої для вибірки

get_mac_list

Змінено у 3.19beta1 (параметр object_type исключен, список object_id зроблено необов'язковим)

Опис: Отримання списку MAC-адрес, які були знайдені на пристрої
Обов'язкові параметри:
 object_type - Тип пристрої [switch] (до версії 3.19beta1)
Необов'язкові параметри:
 interface_list - Номер интерфейса за яким виводити список (можна через кому)
 object_id - id пристрої для вибірки

get_ont_data

Доопрацьовано у: 3.16dev4 (додано параметр device_id)

Додано з: 3.12.81

Опис: Отримання останньої інформації по ONU
Обов'язкові параметри:
 id - MAC-адрес або серійний номер (id)
 або
 device_id - id пристрої (ONU)

get_pon_level_history

Доопрацьовано у: 3.16.19 (додано параметр onu_device_id)

Доопрацьовано у: 3.16dev4 (додано параметр device_id)

Доопрацьовано у: 3.12.60 (додано параметри limit, order_by, is_desc)

Додано з: 3.12.53

Опис: Отримання истории PON-уровней сигналов по ONU
Обов'язкові параметри:
 onu_name - MAC-адрес або серійний номер ONU (без разделителей)
 або
 device_id - id пристрої (OLT)
 або
 onu_device_id - id пристрої (ONU)
Необов'язкові параметри:
 limit - обмеження списку даних, що виводяться
 order_by - поле сортування даних
 is_desc - прапорець - сортировка в обратном порядке

get_relation_customers

Додано у: 3.19.45

Опис: Отримання информации о залежних абонентах
Обов'язкові параметри:
 device_id - id пристрої
Необов'язкові параметри:
 port_start - початковий номер порта
 port_finish - кінцевий номер порта

delete_mark

Змінено у 3.19beta1 (параметр object_type исключен)

Опис: Снятие мітки
Обов'язкові параметри:
 object_type - Тип пристрої [switch] (до версії 3.19beta1)
 object_id - id пристрої
 mark_id - ID мітки

read_fdb

Додано з: 3.15.7

Опис: Чтение FDB-таблиці с пристрої (може виконуватися продолжительное час)
Обов'язкові параметри:
 device_id - id пристрої

set_data

Змінено у 3.19beta1 (параметр object_type исключен)

Доопрацьовано у 3.17dev1 (до параметра param додано можливе значення date_last_activity)

Доопрацьовано у 3.14.53 (до параметра param додано можливе значення downlink_port, uplink_port)

Доопрацьовано у 3.13.61 (до параметра param додано можливе значення iface_count)

Доопрацьовано у 3.12.74 (до параметра param додано можливе значення comment)

Опис: Зміна информации об пристрої
Обов'язкові параметри:
 object_type - Тип пристрої [switch] (до версії 3.19beta1)
 object_id - id пристрої
 param - тип параметра для изменения [ip|mac|comment|iface_count|downlink_port|uplink_port|date_last_activity]
 value - дані (може бути порожнім)

set_iface_state

Додано з: 3.15beta3

Опис: Зміна стану интерфейса на пристрої
Обов'язкові параметри:
 device_id - id пристрої
 iface - номер интерфейса
 state - стан [1|0]

find_mac

Додано з: 3.12beta25

Опис: Поиск MAC-адреса в истории опроса по оборудованию
Обов'язкові параметри:
 mac - MAC-адрес (верхній регістр без разделителей)