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

Материал из WiKi - UserSide
Нет описания правки
 
(не показано 12 промежуточных версий 1 участника)
Строка 1: Строка 1:
[[API_node_EN|en]] | [[API_node|ru]]
Раздел '''[[API]]''' ERP "UserSide"
Раздел '''[[API]]''' ERP "UserSide"


Строка 16: Строка 18:


==== add ====
==== add ====
''Доработано в: 3.16.22 (добавлен параметр level_id)''
''Доработано в: 3.16dev9 (добавлен параметр level)''
  Описание: Добавление объекта
  Описание: Добавление объекта
  Обязательные параметры:
  Обязательные параметры:
   нет
   type - Тип объекта
  Дополнительные параметры:
  Дополнительные параметры:
  type - Тип объекта
   city_id - ID населенного пункта размещения объекта
   city_id - ID населенного пункта размещения объекта
   custom_icon_id - ID индивидуального значка на карте
   custom_icon_id - ID индивидуального значка на карте
Строка 29: Строка 35:
   inventory_number - инв.номер объекта
   inventory_number - инв.номер объекта
   is_planned - Флаг - объект только запланирован
   is_planned - Флаг - объект только запланирован
  level - номер этажа
  level_id - ID этажа/уровня ''(из структуры здания)''
   location - размещение объекта (текстовое)
   location - размещение объекта (текстовое)
   node_parent_id - ID родительского объекта
   node_parent_id - ID родительского объекта
Строка 45: Строка 53:
  Описание: Изменение собственного значка на карте
  Описание: Изменение собственного значка на карте
  Обязательные параметры:
  Обязательные параметры:
   id - ID объекта
   id - id объекта
   custom_icon_id - ID значка
   custom_icon_id - id значка
 
==== delete ====
''Добавлено в: 3.16dev8''
Описание: Удаление сооружения связи
Обязательные параметры:
  id - id объекта


==== delete_mark ====
==== delete_mark ====
Строка 55: Строка 69:


==== edit ====
==== edit ====
''Доработано в: 3.16.22 (добавлен параметр level_id)''
''Доработано в: 3.16dev9 (добавлен параметр level)''
  Описание: Редактирование объекта
  Описание: Редактирование объекта
  Обязательные параметры:
  Обязательные параметры:
Строка 68: Строка 87:
   inventory_number - инв.номер объекта
   inventory_number - инв.номер объекта
   is_planned - Флаг - объект только запланирован
   is_planned - Флаг - объект только запланирован
   location - размещение объекта (текстовое)
  level - номер этажа
  level_id - ID этажа/уровня ''(из структуры здания)''
   location - размещение объекта ''(текстовое)''
   node_parent_id - ID родительского объекта
   node_parent_id - ID родительского объекта
   number - номер объекта
   number - номер объекта
Строка 74: Строка 95:


==== get ====
==== get ====
''Доработано в: 3.13.35 (добавлен параметры mark_id)''
''Доработано в: 3.17beta1 (добавлен параметр entrance_number)''
 
''Доработано в: 3.13.35 (добавлен параметр mark_id)''


''Доработано в: 3.13.14 (добавлен параметры parent_id)''
''Доработано в: 3.13.14 (добавлен параметр parent_id)''


''Доработано в: 3.13alpha1 (добавлен параметр address_id, убраны параметры city_id, street_id, house_id)''
''Доработано в: 3.13alpha1 (добавлен параметр address_id, убраны параметры city_id, street_id, house_id)''
Строка 86: Строка 109:
   нет
   нет
  Необязательные параметры:
  Необязательные параметры:
  id - id объектов ''(можно через запятую)''
  object_type - тип объекта
   address_id - id адресной единицы ''(можно через запятую)'' ''(с версии 3.13)''
   address_id - id адресной единицы ''(можно через запятую)'' ''(с версии 3.13)''
   city_id - id населенного пункта ''(можно через запятую)'' ''(до версии 3.13)''
   city_id - id населенного пункта ''(можно через запятую)'' ''(до версии 3.13)''
   street_id - id улицы ''(можно через запятую)'' ''(до версии 3.13)''
   entrance_number - номер подъезда
   house_id - id дома ''(можно через запятую)'' ''(до версии 3.13)''
   house_id - id дома ''(можно через запятую)'' ''(до версии 3.13)''
  id - id объектов ''(можно через запятую)''
  mark_id - id метки
  object_type - тип объекта
   parent_id - id родительского объекта ''(можно через запятую)''
   parent_id - id родительского объекта ''(можно через запятую)''
   mark_id - id метки
   street_id - id улицы ''(можно через запятую)'' ''(до версии 3.13)''


==== get_icon_list ====
==== get_icon_list ====
Строка 124: Строка 148:
   type - тип объекта
   type - тип объекта
   range - радиус в метрах, в пределах которого отобразить объекты
   range - радиус в метрах, в пределах которого отобразить объекты
==== get_redevelopment_scheme ====
''Добавлено в: 3.16dev3''
Описание: Список схем перепланировки для сооружения связи
Обязательные параметры:
  id - id сооружения связи


==== get_scheme ====
==== get_scheme ====
Строка 131: Строка 161:
   id - id сооружения связи
   id - id сооружения связи


==== get_redevelopment_scheme ====
==== get_type_list ====
''Добавлено в: 3.16dev3''
''Добавлено в: 3.16dev3''
  Описание: Список схем перепланировки для сооружения связи
  Описание: Получение список типов сооружения связи
Обязательные параметры:
  id - id сооружения связи

Текущая версия от 14:15, 23 августа 2023

en | ru

Раздел API ERP "UserSide"

Назначение: Объекты инфраструктуры (узлы связи, муфты, опоры, колодцы)

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

ID типов объектов инфраструктуры:

0 - узел связи (до 3.14.21)
1 - муфта
2 - опора
3 - колодец
4 - узел связи (с 3.14.21)

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

add

Доработано в: 3.16.22 (добавлен параметр level_id)

Доработано в: 3.16dev9 (добавлен параметр level)

Описание: Добавление объекта
Обязательные параметры:
 type - Тип объекта
Дополнительные параметры:
 city_id - ID населенного пункта размещения объекта
 custom_icon_id - ID индивидуального значка на карте
 comment - заметки
 date_add - дата добавления
 entrance - номер подъезда
 house_id - ID дома размещения объекта
 inventory_number - инв.номер объекта
 is_planned - Флаг - объект только запланирован
 level - номер этажа
 level_id - ID этажа/уровня (из структуры здания)
 location - размещение объекта (текстовое)
 node_parent_id - ID родительского объекта
 number - номер объекта
 owner_id - ID собственника
 map_id - ID карты (для версии 3.12 и ранее)
 coordinates - координаты в текстовом виде через запятую (пример: 47.839628,35.140553)

add_mark

Описание: Добавление метки
Обязательные параметры:
 node_id - id объекта
 mark_id - id метки

change_custom_icon

Описание: Изменение собственного значка на карте
Обязательные параметры:
 id - id объекта
 custom_icon_id - id значка

delete

Добавлено в: 3.16dev8

Описание: Удаление сооружения связи
Обязательные параметры:
 id - id объекта

delete_mark

Описание: Снятие метки
Обязательные параметры:
 node_id - id объекта
 mark_id - id метки

edit

Доработано в: 3.16.22 (добавлен параметр level_id)

Доработано в: 3.16dev9 (добавлен параметр level)

Описание: Редактирование объекта
Обязательные параметры:
 id - ID объекта
Необязательные параметры:
 city_id - ID населенного пункта размещения объекта
 custom_icon_id - ID индивидуального значка на карте
 comment - заметки
 coordinates - координаты в текстовом виде через запятую (пример: 47.839628,35.140553)
 date_add - дата добавления
 entrance - номер подъезда
 house_id - ID дома размещения объекта
 inventory_number - инв.номер объекта
 is_planned - Флаг - объект только запланирован
 level - номер этажа
 level_id - ID этажа/уровня (из структуры здания)
 location - размещение объекта (текстовое)
 node_parent_id - ID родительского объекта
 number - номер объекта
 owner_id - ID собственника

get

Доработано в: 3.17beta1 (добавлен параметр entrance_number)

Доработано в: 3.13.35 (добавлен параметр mark_id)

Доработано в: 3.13.14 (добавлен параметр parent_id)

Доработано в: 3.13alpha1 (добавлен параметр address_id, убраны параметры city_id, street_id, house_id)

Доработано в: 3.12.74 (добавлены параметры city_id, street_id, house_id)

Описание: Список объектов
Обязательные параметры:
 нет
Необязательные параметры:
 address_id - id адресной единицы (можно через запятую) (с версии 3.13)
 city_id - id населенного пункта (можно через запятую) (до версии 3.13)
 entrance_number - номер подъезда
 house_id - id дома (можно через запятую) (до версии 3.13)
 id - id объектов (можно через запятую)
 mark_id - id метки
 object_type - тип объекта
 parent_id - id родительского объекта (можно через запятую)
 street_id - id улицы (можно через запятую) (до версии 3.13)

get_icon_list

Описание: Список собственных значков для объектов
Необязательные параметры:
 id - перечень ID объектов (через запятую)

get_id

Доработано в: 3.14.46 (добавлен параметр type_id)

Доработано в: 3.12.72 (добавлено возможное значение comment, добавлен параметр is_entry)

Доработано в: 3.12.71 (добавлено возможное значение additional_dataX)

Описание: Получение ID объекта по входящим данным
Обязательные параметры:
 data_type - тип данных, которые проверяем (возможные значения: comment, number, additional_dataX (вместо X - id дополнительного поля))
 data_value - значение
Необязательные параметры:
 is_entry - флаг - проверять ли в т.ч. совпадение по части вхождения в строку
 type_id - тип объекта

get_id_by_coord

Добавлено в: 3.12beta30

Описание: Получение ID ближайшего объекта по указанным координатам
Обязательные параметры:
 lat - широта
 lon - долгота
Необязательные параметры:
 type - тип объекта
 range - радиус в метрах, в пределах которого отобразить объекты

get_redevelopment_scheme

Добавлено в: 3.16dev3

Описание: Список схем перепланировки для сооружения связи
Обязательные параметры:
 id - id сооружения связи

get_scheme

Добавлено в: 3.15.15

Описание: Получение схемы коммутации
Обязательные параметры:
 id - id сооружения связи

get_type_list

Добавлено в: 3.16dev3

Описание: Получение список типов сооружения связи