API EN

en | ru

This section describes the possibilities of using the inbuilt API in ERP "UserSide", which allows you to use the integrated functionality in your own projects.

The API does not cover all functionality at the moment and is gradually being developed, so this page will have frequent changes and additions.

Operating principle

The /api.php file is responsible for interaction.

Both GET and POST requests can be used.

Incoming Parameters:
Mandatory:
 key - API key
 cat - category of the request
Optional:
 skip_internal_api - flag - do not include internal system triggers (reasonable to use when your API method is a reaction to some trigger and it ends up looping itself during normal operation)
Other additional parameters, depending on the category (see below in the relevant categories). 
For example:
 customer_id - user id of the customer
 is_potential - flag. It can take the value 1 or 0. Most flags have the prefix is.

Example request:
api.php?key=apikey&cat=abon&action=msg&usercode=1

Returned data:
 If the query involves some action or information return, information will be returned in JSON format:
  array(
   [Result] => OK / ERROR
   [ErrorText] => In case of an error, the error text
  )

It is also reasonable to check the HTTP code of the response. In case of errors/incorrect requests - HTTP code will be different from 200

Basic setting

Configure the API Key.

Categories

• address - Addresses
• attach - Attachments
• additional_data - Additional fields/data for objects
• advertising - Advertising campaigns
• billing - Billing
• cable_route - Cable routes and channels
• call - Calls
• commutation - Commutation of objects
• cross - ODF/Crosses
• customer - Users. Most actions are relevant for manual billing
• cwdm - CWDM
• device - Equipment
• employee - Employees (since 3.16dev2)'
• fiber - Cable lines
• gps - GPS trackers
• inventory - Warehouse
• key - Keys
• map - Coverage maps
• module - External requests from modules
• newin - Connection request
• node - Communication facilities (communication nodes, fiber optical junction boxes, poles, manholes)'
• notepad - Notepad
• operator - system operators ( before 3.16dev2)'
• owner - Object Owners
• redirect - Redirects to an object card based on some attribute
• service - Additional services
• setting - Setting
• sms - SMS messages
• splitter - dividers/splitters
• staff - Staff (up to 3.16dev2)'
• system - System information and operations
• tariff - Tariffs
• task - Tasks
• trader - Vendors
• vehicle - Vehicles
• vlan - Vlan