API device: различия между версиями

Материал из WiKi - UserSide
Перейти к навигации Перейти к поиску
(set_data)
(get_device_id)
 
Строка 9: Строка 9:
  
 
==== get_device_id ====
 
==== get_device_id ====
''Доработано в: 3.12.95 (добавлен data_typer=mac)''
+
''Доработано в: 3.13.63 (в data_typer добавлено возможное значение serial_number)''
 +
 
 +
''Доработано в: 3.12.95 (в data_typer добавлено возможное значение mac)''
 
  Описание: Получение ID устройства по входящим данным
 
  Описание: Получение ID устройства по входящим данным
 
  Обязательные параметры:
 
  Обязательные параметры:
 
   object_type - Тип устройства [switch]
 
   object_type - Тип устройства [switch]
   data_typer - тип данных, которые проверяем ''(возможные значения: ip, mac, inventory_number, additional_field_XXX)''
+
   data_typer - тип данных, которые проверяем ''(возможные значения: ip, mac, inventory_number, serial_number, additional_field_XXX)''
 
   data_value - значение
 
   data_value - значение
  

Текущая версия на 15:00, 8 октября 2019

Раздел API ERP "UserSide"

Назначение: Оборудование

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

Подкатегории

get_device_id

Доработано в: 3.13.63 (в data_typer добавлено возможное значение serial_number)

Доработано в: 3.12.95 (в data_typer добавлено возможное значение mac)

Описание: Получение ID устройства по входящим данным
Обязательные параметры:
 object_type - Тип устройства [switch]
 data_typer - тип данных, которые проверяем (возможные значения: ip, mac, inventory_number, serial_number, additional_field_XXX)
 data_value - значение

get_data

Доработано в: 3.12.38 (добавлен object_type=all)

Описание: Получение информации об устройствах
Обязательные параметры:
 object_type - Тип устройства [switch|onu|radio|all]
Необязательные параметры:
 object_id - id объекта для выборки
 is_online - флаг - выбирать только активные устройства

get_iface_mac

Добавлено с: 3.12beta25

Описание: Список интерфейсов с MAC-адресами на устройстве
Обязательные параметры:
 object_type - Тип устройства [switch]
 object_id - id устройства для выборки

get_mac_list

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

get_ont_data

Добавлено с: 3.12.81

Описание: Получение последней информации по ONT/ONU
Обязательные параметры:
 id - MAC-адрес или серийный номер (id)

get_pon_level_history

Добавлено с: 3.12.53

Доработано в: 3.12.60 (добавлены параметры limit, order_by, is_desc)

Описание: Получение истории PON-уровней сигналов по ONU/ONT
Обязательные параметры:
 onu_name - MAC-адрес или серийный номер ONU/ONT (без разделителей)
Необязательные параметры:
 limit - ограничение списка выводимых данных
 order_by - поле сортировки данных
 is_desc - флаг - сортировка в обратном порядке

add_mark

Описание: Добавление метки
Обязательные параметры:
 object_type - Тип устройства [switch]
 object_id - id устройства
 mark_id - ID метки

delete_mark

Описание: Снятие метки
Обязательные параметры:
 object_type - Тип устройства [switch]
 object_id - id устройства
 mark_id - ID метки

set_data

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

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

Описание: Изменение информации об устройстве
Обязательные параметры:
 object_type - Тип устройства [switch]
 object_id - id устройства
 param - тип параметра для изменения [ip|mac|comment|iface_count]
 value - данные (может быть пустым)

find_mac

Добавлено с: 3.12beta25

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