API EN: различия между версиями
IronBot (обсуждение | вклад) (Fix Ukrainian API localization) |
IronBot (обсуждение | вклад) ([IronBot] Sync EN localization from RU) |
||
| (не показаны 2 промежуточные версии этого же участника) | |||
| Строка 10: | Строка 10: | ||
Both GET and POST requests can be used. | Both GET and POST requests can be used. | ||
'''Starting with version 3.21, all requests that write or modify data are processed only through POST.''' | |||
Input parameters: | Input parameters: | ||
| Строка 49: | Строка 51: | ||
* [[API_commutation_EN|commutation]] - Commutation of objects | * [[API_commutation_EN|commutation]] - Commutation of objects | ||
* [[API_cross_EN|cross]] - Distribution frames | * [[API_cross_EN|cross]] - Distribution frames | ||
* [[API_customer_EN|customer]] - Customers. Most actions are relevant for [[ | * [[API_customer_EN|customer]] - Customers. Most actions are relevant for [[Supported_billings|manual billing]] | ||
* [[API_cwdm_EN|cwdm]] - CWDM | * [[API_cwdm_EN|cwdm]] - CWDM | ||
* [[API_device_EN|device]] - Equipment | * [[API_device_EN|device]] - Equipment | ||
Текущая версия от 14:58, 29 мая 2026
This section describes how to use the built-in ERP "UserSide" API in your own projects.
The API does not currently cover all functionality and is being expanded gradually, so this page may change frequently.
Operating principle
The /api.php file is responsible for interaction.
Both GET and POST requests can be used.
Starting with version 3.21, all requests that write or modify data are processed only through POST.
Input parameters: Required: key - API key cat - request category Optional: skip_internal_api - flag - do not run internal system triggers (useful when an API method is called from a trigger and would otherwise trigger itself during normal operation) Other additional parameters, depending on the category (see below in the relevant categories). For example: customer_id - customer id is_potential - flag. It can be 1 or 0. Most flags use the is prefix. Example request: api.php?key=apikey&cat=abon&action=msg&usercode=1
Returned data: If the request performs an action or returns data, the response is returned in JSON format: array( [Result] => OK / ERROR [ErrorText] => Error text, if an error occurred )
Also check the HTTP response code. For errors or invalid requests, the HTTP code will differ from 200.
Basic setup
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
- chapter - Custom sections/pages/links
- commutation - Commutation of objects
- cross - Distribution frames
- customer - Customers. 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 (before 3.18)
- node - Infrastructure facilities (communication nodes, splice closures, poles, manholes)
- notepad - Notepad
- operator - System operators (before 3.16dev2)
- owner - Owners
- redirect - Redirects to an object card by attribute
- service - Additional services
- setting - Settings
- sms - SMS messages
- splitter - Splitters
- staff - Staff (up to 3.16dev2)
- system - System information and operations
- tariff - Tariffs
- task - Tasks
- trader - Vendors
- vehicle - Vehicles
- vlan - VLAN