API node EN

Материал из WiKi - UserSide
Версия от 14:40, 24 августа 2023; N.Skrypnik (обсуждение | вклад)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

en | ru

Section API ERP "UserSide"

Purpose: Infrastructure facilities (Communication nodes, Fiber Optical Junction Boxes, Poles, Manholes)

Additional parameters:
action - request subcategory (possible value: see below)

IDs of infrastructure object types:

0 - Communication node (up to 3.14.21)
1 - Fiber Optical Junction Box
2 - Pole
3 - Manhole
4 - Communication node (from 3.14.21)

Subcategories

add

Modified in: 3.16.22 (added level_id parameter)

Modified in: 3.16dev9 (added level parameter)

Description: Adding an object
Obligatory parameters:
 type - Type of object
Optional parameters:
 city_id - ID of the locality where the object is located
 custom_icon_id - ID of custom icon on the map
 comment - notes
 date_add - date added
 entrance - entrance number
 house_id - ID of the object location house
 inventory_number - inventory number of the object
 is_planned - Flag - object is only planned
 level - floor number
 level_id - floor/level ID (from building structure)
 location - object location (text)
 node_parent_id - ID of parent object
 number - object number
 owner_id - owner ID
 map_id - map ID (for version 3.12 and earlier)
 coordinates - coordinates in text form separated by commas (example: 47.839628,35.140553)

add_mark

Description: Adding a mark
Obligatory parameters:
 node_id - object id
 mark_id - mark id

change_custom_icon

Description: Change custom icon on the map
Obligatory parameters:
 id - object id
 custom_icon_id - icon id

delete

Added in: 3.16dev8

Description: Deletion of a communication facility
Mandatory parameters:
 id - object id

delete_mark

Description: Deleting a mark
Obligatory parameters:
 node_id - object id
 mark_id - mark id

edit

Modified in: 3.16.22 (added level_id parameter)

Modified in: 3.16dev9 (added level parameter)

Description: Edit object
Obligatory parameters:
 id - object ID
Optional parameters:
 city_id - ID of the locality where the object is located
 custom_icon_id - ID of custom icon on the map
 comment - notes
 coordinates - coordinates in text form with comma (example: 47.839628,35.140553)
 date_add - date added
 entrance - entrance number
 house_id - ID of the house where the object is located
 inventory_number - inventory number of the object
 is_planned - Flag - object is only planned
 level - floor number
 level_id - floor/level ID (from the building structure)
 location - object location (text)
 node_parent_id - ID of parent object
 number - object number
 owner_id - owner ID

get

Modified in: 3.17beta1 (added entrance_number parameter)

Modified in: 3.13.35 (added mark_id parameter)

Modified at: 3.13.14 (added parent_id parameter)

Modified in: 3.13alpha1 (added address_id parameter, removed city_id, street_id, house_id parameters)

Modified in: 3.12.74 (added city_id, street_id, house_id parameters)

Description: List of objects
Obligatory parameters:
 None
Optional parameters:
 address_id - address unit id (can be comma separated) (since version 3.13)
 city_id - id of the settlement (can be comma separated) (before version 3.13)
 entrance_number - entrance number
 house_id - house id (can be comma separated) (before version 3.13)
 id - object id (can be comma separated)
 mark_id - mark id
 object_type - object type
 parent_id - id of parent object (can be comma separated)
 street_id - street id (can be comma separated) (before version 3.13)

get_icon_list

Description: List of custom icons for objects
Optional parameters:
 id - list of object IDs (can be comma separated)

get_id

Modified in: 3.14.46 (added type_id parameter)

Modified in: 3.12.72 (added possible comment value, added is_entry parameter)

Modified in: 3.12.71 (added possible value of additional_dataX)

Description: Obtain object ID from incoming data
Obligatory parameters:
 data_type - type of data we are checking (possible values: comment, number, additional_dataX (instead of X - id of additional field))
 data_value - value
Optional parameters:
 is_entry - flag - whether to check for a match in part of string occurrence
 type_id - object type

get_id_by_coord

Added in: 3.12beta30

Description: Get ID of the nearest object by specified coordinates
Obligatory parameters:
 lat - latitude
 lon - longitude
Optional parameters:
 type - type of object
 range - radius in metres within which to display objects

get_redevelopment_scheme

Added in: 3.16dev3

Description: List of redevelopment schemes for a communication facility
Obligatory parameters:
 id - id of communication facility

get_scheme

Added in: 3.15.15

Description: Obtaining a switching scheme
Obligatory parameters:
 id - id of communication facility

get_type_list

Added in: 3.16dev3

Description: Get the list of communication facility types