Difference between revisions of "MOR API users get"
From Kolmisoft Wiki
Jump to navigationJump to search
(Created page with '.') |
|||
| Line 1: | Line 1: | ||
. | <!---This functionality is available from [[MOR 8| MOR 8]]---> | ||
=Description= | |||
[[MOR API]] for getting list of users | |||
*'''Admin or Accountant with permissions''' can get all users list | |||
*'''Reseller''' can get his own users list | |||
*'''Partner''' can get his resellers and users | |||
<br><br> | |||
=Usage= | |||
* From '''MOR X8''' call: /api/users_get | |||
* Methods: POST, GET(if allowed, not recomended) | |||
<br><br> | |||
===Parameters=== | |||
Parameters which are included into hash | |||
* u - username to login. '''Required'''. | |||
* p - password to login. '''Required'''. | |||
*[[MOR API hash construction | hash]] – SHA1 hash constructed using '''API Secret Key''' ([[MOR API hash construction | More described in Constructing hash]]). '''Required'''. | |||
<br><br> | |||
===Request=== | |||
If API Secret Key = secret | |||
You send: | |||
HTML POST: http://<SERVER_IP>/billing/api/users_get?u=admin&p=admin1&test=1&hash=c420ef706a02e6449994b7575b25ef5f74cc722b | |||
<br><br> | |||
===Returns=== | |||
<?xml version="1.0" encoding="UTF-8"?> | |||
<page> | |||
<status> | |||
<users> | |||
<user> | |||
<id> ... </id> | |||
<username> ... </username> | |||
<first_name> ... </first_nam> | |||
<last_name> ... </last_name> | |||
<balance> ... </balance> | |||
<blocked> ... </blocked> | |||
<lcr_id> ... </lcr_id> | |||
<tariff_id> ... </tariff_id> | |||
<owner_id> ... </owner_id> | |||
<usertype> ... </usertype> | |||
</user> | |||
</users> | |||
</status> | |||
</page> | |||
'''Errors:''' | |||
* <error>API Requests are disabled</error> – '''Allow API globally''' setting is unchecked | |||
* <error>GET Requests are disabled</error> – '''Allow GET API''' setting is unchecked | |||
* <error>Access Denied</error> – User is not allowed to to get users list or username and password are not correct. | |||
* <error>Incorrect hash</error> – Hash was not correct. Check API_Secret_Key and order of parameters while concatenating the hash_string | |||
* <error>You are not authorized to view this page</error> – User is not authorized to get users list. | |||
Example: | |||
<status> | |||
<error>API Requests are disabled</error> | |||
</status> | |||
<br><br> | |||
=See also= | |||
* [[MOR API]] | |||
Latest revision as of 09:45, 30 August 2016
Description
MOR API for getting list of users
- Admin or Accountant with permissions can get all users list
- Reseller can get his own users list
- Partner can get his resellers and users
Usage
- From MOR X8 call: /api/users_get
- Methods: POST, GET(if allowed, not recomended)
Parameters
Parameters which are included into hash
- u - username to login. Required.
- p - password to login. Required.
- hash – SHA1 hash constructed using API Secret Key ( More described in Constructing hash). Required.
Request
If API Secret Key = secret
You send:
HTML POST: http://<SERVER_IP>/billing/api/users_get?u=admin&p=admin1&test=1&hash=c420ef706a02e6449994b7575b25ef5f74cc722b
Returns
<?xml version="1.0" encoding="UTF-8"?>
<page>
<status>
<users>
<user>
<id> ... </id>
<username> ... </username>
<first_name> ... </first_nam>
<last_name> ... </last_name>
<balance> ... </balance>
<blocked> ... </blocked>
<lcr_id> ... </lcr_id>
<tariff_id> ... </tariff_id>
<owner_id> ... </owner_id>
<usertype> ... </usertype>
</user>
</users>
</status>
</page>
Errors:
- <error>API Requests are disabled</error> – Allow API globally setting is unchecked
- <error>GET Requests are disabled</error> – Allow GET API setting is unchecked
- <error>Access Denied</error> – User is not allowed to to get users list or username and password are not correct.
- <error>Incorrect hash</error> – Hash was not correct. Check API_Secret_Key and order of parameters while concatenating the hash_string
- <error>You are not authorized to view this page</error> – User is not authorized to get users list.
Example:
<status> <error>API Requests are disabled</error> </status>
