API fiber EN

en | ru

Section API ERP "UserSide"

Purpose: Cable lines

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

Subcategories

add

Modified in: 3.15.23 (added cableline_type_id parameters)

Description: Adding a line
Obligatory parameters:
 object_a_id - ID of the initial object
 object_b_id - ID of the final object (or house_b_id - ID of the final house or customer_b_id - ID of the final customer)
Optional parameters:
 building_date - Date of laying
 building_length - building length
 cableline_type_id - cable line type ID
 cabletype_id - cable type ID
 comment - Notes
 custom_color - Custom color for the line
 customer_b_id - ID of the final customer
 fibers_count - number of fibers
 house_b_id - ID of the final house
 is_planned - Flag - object is only planned
 is_change_color_by_cabletype - Flag - Change fiber colours according to cable type properties
 marking_a - Line marking on side A
 marking_b - Line marking on side B
 object_a_id - ID of the initial object
 object_b_id - ID of final object
 optical_length - optical length

add_mark

Added in 3.13.35

Description: Adding a mark
Obligatory parameters:
 fiber_id - line id
 mark_id - mark id

add_route_object

Added in 3.13.14

Description: Adds an object to a line route
Obligatory parameters:
 id - id of the line
 object_id - object id
Optional parameters:
 reserve - cable reserve (in meters)

catalog_cables_add

Added in 3.17dev1

Description: Adds an entry to the cables catalogue
Obligatory parameters:
 cable_line_type_id - cable line type id
 brand - manufacturer name
 name - cable brand
 core_count - number of conductors (fibers/core)

catalog_cables_get

Added in 3.15.12

Description: Catalogue of cables
Optional parameters:
 cable_line_type_id - id of cable line type

catalog_types_get

Added in 3.15.12

Description: Catalogue of cable line types

delete

Added in: 3.16dev8

Description: Deleting a cable line
Obligatory parameters:
 id - object id

delete_mark

Added in 3.13.35

Description: Removing a mark
Obligatory parameters:
 fiber_id - line id
 mark_id - mark id

edit

Description: Line editing
Obligatory parameters:
 id - line id
Optional parameters:
 object_a_id - id of the start object
 object_b_id - id of the final object 
 house_b_id - id of the final house
 building_date - date of laying
 building_length - building length
 cabletype_id - cable type id
 cable_line_type_id - cable line type id
 comment - notes
 custom_color - custom colour for the line
 fibers_count - number of fibers
 house_b_id - ID of the final house
 is_planned - flag - object is only planned
 is_change_color_by_cabletype - flag - Change fiber colours according to cable type properties
 marking_a - line marking on A side
 marking_b - line marking on side B
 optical_length - optical length

get_fiber

Modified in: 3.14beta5 (added fiber_id parameters)

Added in 3.12.94

Description: List of fibers
Obligatory parameters:
 None
Optional parameters:
 fiber_id - cable line id (can be comma separated)
 id - fiber id (can be comma separated)

get_geo_length

Added in 3.13.14

Description: Calculation of line length according to geographical coordinates of endpoints (approximate calculation)
Obligatory parameters:
 id - line id

get_list

Modified in: 3.16.19 (added cable_line_type_id parameters)

Modified in: 3.13.45 (added node_id parameters)

Modified in: 3.13.35 (added mark_id parameters)

Description: List of lines
Obligatory parameters:
 None
Optional parameters:
 cable_line_type_id - id of cable line type
 mark_id - mark id
 node_id - id of placement object (can be comma separated)
 object_id - id of the specific line

map_color_get

Added in 3.16dev8

Description: Cable colours on the map

remove_route_object

Added in 3.13.14

Description: Excludes objects on the line route
Obligatory parameters:
 id - id of the line
Optional parameters:
 object_id - object id

set_geo_route

Added in 3.13.45

Description: Set the geographical route of the line
Obligatory parameters:
 id - id of the line
 route - array of geographical points (lat,lon) of the line route in json format

set_pigtail_type

Added in 3.19.35

Description: Set the pigtail type for a line fiber/conductor
Required parameters:
 id - line id
 side - line side [1|2]
 number - fiber/conductor number
 pigtail_type - pigtail type

pigtail_type variants:

 1001 - SC UPC
 1002 - LC UPC
 1003 - FC UPC
 1004 - ST UPC
 1005 - E2000 UPC
 1011 - SC APC
 1012 - LC APC
 1013 - FC APC
 1014 - ST APC
 1015 - E2000 APC
 10010 - SC UPC Female
 10011 - SC APC Female
 1100 - no pigtail
 5000 - failed