MOR API user details update
From Kolmisoft Wiki
Jump to navigationJump to search
This functionality is available from MOR 11
MOR API
Update user from params.
Please note that it is not necessary to send ALL user parameters - you can send only those you need to update.
- Call: /api/user_update_api
- Methods: POST, GET(if allowed, not recomended)
- Params:
- user_id - Users ID in MOR database, whose details we want to change. REQUIRED.
- u - username of user which can modify details (admin, reseller or accountant). REQUIRED.
- p - password of user which can modify details (admin, reseller or accountant). REQUIRED.
- hash - SHA1 hash constructed using params and API_Secret_Key ( More described in Constructing hash). REQUIRED.
- u0 - vat number
- u1 - lcr id
- u2 - warning email hour
- u3 - hide destination end
- u4 - currency id
- u5 - tariff id
- u6 - warning email balance
- u7 - spy device id
- u8 - language
- u9 - username
- u10 - warning balance call
- u11 - acc group id
- u12 - generate invoice
- u13 - usertype
- u14 - taxation country
- u15 - blocked
- u16 - quickforwards rule id
- u17 - last name
- u18 - call limit
- u19 - clientid
- u20 - recording hdd quota
- u21 - cyberplat active
- u22 - recordings email
- u23 - first name
- u24 - warning balance sound file id
- u25 - postpaid
- u26 - accounting number
- u27 - agreement number
- u28 - hidden
- ay - agr_date year
- am - agr_date month
- ad - agr_date day
- by - block at date year2011
- bm - block at date month
- bd - block at date day
- pswd - password
- user_warning_email_hour
- pgui - privacy gui [0-off, 1-on]
- pcsv - privacy csv [0-off, 1-on]
- ppdf - privacy pdf [0-off, 1-on]
- recording_forced_enabled - [0-off, 1-on]
- i4 - invoice detailed csv [0-off, 16-on]
- tax4_enabled - [0-off, 1-on]
- tax2_enabled - [0-off, 1-on]
- accountant_type_invalid
- block_at_conditional - 15
- tax3_enabled - [0-off, 1-on]
- accountant_type
- tax1_value - float
- show_zero_calls - [0-off, 1-on]
- warning_email_active - [0-off, 1-on]
- compound_tax - [0-off, 1-on]
- tax4_name -
- allow_loss_calls - [0-off, 1-on]
- tax3_name -
- tax2_name -
- credit - float
- tax1_name -
- total_tax_name -
- tax2_value - float
- tax4_value - float
- ignore_global_monitorings - [0-off, 1-on]
- i1 - invoice pdf [0-off, 2-on]
- tax3_value - float
- cyberplat_active - [0-off, 1-on]
- i2 - invoice csv [0-off, 4-on]
- i3 - invoice detailed pdf [0-off, 8-on]
- recording_enabled - [0-off, 1-on]
- email_warning_sent_test - [0-off, 1-on]
- own_providers - [0-off, 1-on]
- a0 - address
- a1 - city
- a2 - postcode
- a3 - county
- a4 - mob_phone
- a5 - fax
- a6 - direction id
- a7 - phone
- a8 - email
- a9 - satate
- Returns:
- Success
- <status>User was updated</status>
- Errors:
- <error>User was not found</error> - User was not found using user_id. Use correct user id.
- <error>Incorrect hash</error> - Hash was not correct. Check API_Secret_Key and order or params while concatenating hash_string.
- <error>Dont be so smart</error> - Check params and permissions.
- <error>Bad login</error> - User with u and p not found. Enter username or password.
- <error>You have no editing permission</error> - Accountant dont have permission.
- <error>Tariff not found</error> - Tariff was not found using param u5.
- <error>User was not updated</error>
- <message>problem message</message>
- Success
Examples
- We have user_id = 123, API Secret Key = 456789, u15=1 (we want to block user)
- Hash string to be converted: "1231456789"
- We send:
- /api/user_update_api?u=admin&p=admin&user_id=123&u15=1&hash=0ab3ede4e93a55c38855a2cc9b9e169d35442c48
* Note that username and password are not included in hash
Other examples:
- http:/123.123.123.123/billing/api/user_update_api?u15=1&user_id=789&u=admin&p=mv0osob0&u15=1&hash=0in2w8n01rwnodv4t0y5zzfp1h5hdp1fyk7z
This request blocks (u15=1) user with ID 789 (user_id=789). User belongs to admin (u=admin). Admin's password in this example is "mv0osob0" (p=mv0osob0).
- http:/123.123.123.123/billing/api/user_update_api?u16=3&user_id=789&u=admin&p=mv0osob0&u15=1&hash=0in2w8n01rwnodv4t0y5zzfp1h5hdp1fyk7z
This request changes user quickforwards rule to rule with ID 3 (u16=3) user with ID 789 (user_id=789). User belongs to admin (u=admin). Admin's password in this example is "mv0osob0" (p=mv0osob0).