API node: различия между версиями
Admin (обсуждение | вклад) Нет описания правки |
Нет описания правки |
||
(не показано 45 промежуточных версий 1 участника) | |||
Строка 1: | Строка 1: | ||
[[API_node_EN|en]] | [[API_node|ru]] | |||
Раздел '''[[API]]''' ERP "UserSide" | Раздел '''[[API]]''' ERP "UserSide" | ||
Строка 5: | Строка 7: | ||
Дополнительные параметры: | Дополнительные параметры: | ||
action - подкатегория запроса ''(возможное значение: см.ниже)'' | 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 населенного пункта размещения объекта | 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 родительского объекта | ||
number - номер объекта | number - номер объекта | ||
owner_id - ID собственника | 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 ==== | ==== edit ==== | ||
''Доработано в: 3.16.22 (добавлен параметр level_id)'' | |||
''Доработано в: 3.16dev9 (добавлен параметр level)'' | |||
Описание: Редактирование объекта | Описание: Редактирование объекта | ||
Обязательные параметры: | Обязательные параметры: | ||
id - ID объекта | id - ID объекта | ||
Необязательные параметры: | |||
city_id - ID населенного пункта размещения объекта | city_id - ID населенного пункта размещения объекта | ||
custom_icon_id - ID индивидуального значка на карте | custom_icon_id - ID индивидуального значка на карте | ||
comment - заметки | comment - заметки | ||
coordinates - координаты в текстовом виде через запятую ''(пример: 47.839628,35.140553)'' | |||
date_add - дата добавления | date_add - дата добавления | ||
entrance - номер подъезда | entrance - номер подъезда | ||
Строка 51: | Строка 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 - номер объекта | ||
owner_id - ID собственника | 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'' | |||
Описание: Получение список типов сооружения связи |
Текущая версия от 14:15, 23 августа 2023
Раздел 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
Описание: Получение список типов сооружения связи