API node: различия между версиями
Admin (обсуждение | вклад) |
Нет описания правки |
||
(не показаны 23 промежуточные версии 1 участника) | |||
Строка 1: | Строка 1: | ||
[[API_node_EN|en]] | [[API_node|ru]] | |||
Раздел '''[[API]]''' ERP "UserSide" | Раздел '''[[API]]''' ERP "UserSide" | ||
Строка 7: | Строка 9: | ||
ID типов объектов инфраструктуры: | ID типов объектов инфраструктуры: | ||
0 - узел связи | 0 - узел связи ''(до 3.14.21)'' | ||
1 - муфта | 1 - муфта | ||
2 - опора | 2 - опора | ||
3 - колодец | 3 - колодец | ||
4 - узел связи ''(с 3.14.21)'' | |||
== Подкатегории == | == Подкатегории == | ||
==== add ==== | ==== add ==== | ||
''Доработано в: 3.16.22 (добавлен параметр level_id)'' | |||
''Доработано в: 3.16dev9 (добавлен параметр level)'' | |||
Описание: Добавление объекта | Описание: Добавление объекта | ||
Обязательные параметры: | Обязательные параметры: | ||
type - Тип объекта | |||
Дополнительные параметры: | Дополнительные параметры: | ||
city_id - ID населенного пункта размещения объекта | city_id - ID населенного пункта размещения объекта | ||
custom_icon_id - ID индивидуального значка на карте | custom_icon_id - ID индивидуального значка на карте | ||
Строка 28: | Строка 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 карты | map_id - ID карты ''(для версии 3.12 и ранее)'' | ||
coordinates - координаты в текстовом виде через запятую ''(пример: 47.839628,35.140553)'' | coordinates - координаты в текстовом виде через запятую ''(пример: 47.839628,35.140553)'' | ||
==== add_mark ==== | ==== add_mark ==== | ||
Строка 48: | Строка 53: | ||
Описание: Изменение собственного значка на карте | Описание: Изменение собственного значка на карте | ||
Обязательные параметры: | Обязательные параметры: | ||
id - | id - id объекта | ||
custom_icon_id - | custom_icon_id - id значка | ||
==== delete ==== | |||
''Добавлено в: 3.16dev8'' | |||
Описание: Удаление сооружения связи | |||
Обязательные параметры: | |||
id - id объекта | |||
==== delete_mark ==== | ==== delete_mark ==== | ||
Описание: Снятие метки | Описание: Снятие метки | ||
Обязательные параметры: | Обязательные параметры: | ||
node_id - | node_id - id объекта | ||
mark_id - | mark_id - id метки | ||
==== edit ==== | ==== edit ==== | ||
''Доработано в: 3.16.22 (добавлен параметр level_id)'' | |||
''Доработано в: 3.16dev9 (добавлен параметр level)'' | |||
Описание: Редактирование объекта | Описание: Редактирование объекта | ||
Обязательные параметры: | Обязательные параметры: | ||
Строка 65: | Строка 81: | ||
custom_icon_id - ID индивидуального значка на карте | custom_icon_id - ID индивидуального значка на карте | ||
comment - заметки | comment - заметки | ||
coordinates - координаты в текстовом виде через запятую ''(пример: 47.839628,35.140553)'' | |||
date_add - дата добавления | date_add - дата добавления | ||
entrance - номер подъезда | entrance - номер подъезда | ||
Строка 70: | Строка 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 ==== | ==== get ==== | ||
''Доработано в: 3.13.14 (добавлен | ''Доработано в: 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.13alpha1 (добавлен параметр address_id, убраны параметры city_id, street_id, house_id)'' | ||
Строка 90: | Строка 109: | ||
нет | нет | ||
Необязательные параметры: | Необязательные параметры: | ||
address_id - id адресной единицы ''(можно через запятую)'' ''(с версии 3.13)'' | address_id - id адресной единицы ''(можно через запятую)'' ''(с версии 3.13)'' | ||
city_id - id населенного пункта ''(можно через запятую)'' ''(до версии 3.13)'' | city_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 родительского объекта ''(можно через запятую)'' | ||
street_id - id улицы ''(можно через запятую)'' ''(до версии 3.13)'' | |||
==== get_icon_list ==== | ==== get_icon_list ==== | ||
Строка 102: | Строка 123: | ||
Необязательные параметры: | Необязательные параметры: | ||
id - перечень ID объектов ''(через запятую)'' | id - перечень ID объектов ''(через запятую)'' | ||
==== get_id ==== | ==== get_id ==== | ||
''Доработано в: 3.14.46 (добавлен параметр type_id)'' | |||
''Доработано в: 3.12.72 (добавлено возможное значение comment, добавлен параметр is_entry)'' | ''Доработано в: 3.12.72 (добавлено возможное значение comment, добавлен параметр is_entry)'' | ||
Строка 118: | Строка 137: | ||
Необязательные параметры: | Необязательные параметры: | ||
is_entry - флаг - проверять ли в т.ч. совпадение по части вхождения в строку | is_entry - флаг - проверять ли в т.ч. совпадение по части вхождения в строку | ||
type_id - тип объекта | |||
==== get_id_by_coord ==== | ==== get_id_by_coord ==== | ||
Строка 132: | Строка 148: | ||
type - тип объекта | type - тип объекта | ||
range - радиус в метрах, в пределах которого отобразить объекты | 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
Описание: Получение список типов сооружения связи