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

Материал из WiKi - UserSide
(Новая страница: «en | ru Section '''API''' ERP "UserSide"»)
 
Нет описания правки
 
Строка 2: Строка 2:


Section '''[[API_EN|API]]''' ERP "UserSide"
Section '''[[API_EN|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

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

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