Difference between revisions of "MOR API rate get"
From Kolmisoft Wiki
Jump to navigationJump to search
(One intermediate revision by one other user not shown) | |||
Line 29: | Line 29: | ||
===Parameters=== | ===Parameters=== | ||
* u - username for authentication. '''From X5 - Required'''. | * u - username for authentication. '''From X5 - Required'''. If the u parameter is the username of a simple user, the global setting [https://wiki.kolmisoft.com/index.php/Configuration_from_GUI#Tariffs/Rates 'Show rates for users'] must be enabled. | ||
* username – username of user whose rates you want to see. | * username – username of the user whose rates you want to see. | ||
* prefix – prefix number of destination you want to see. | * prefix – prefix number of the destination you want to see. | ||
* by_full_dst - changes ''prefix'' parameter behavior. If parameter ''by_full_dst=1'', then you can pass full numbers in ''prefix'' parameter and best matching | * by_full_dst - changes ''prefix'' parameter behavior. If parameter ''by_full_dst=1'', then you can pass full numbers in ''prefix'' parameter and best matching rates will be returned. If parameter ''by_full_dst'' is not included, then MOR will return rate for the exact prefix passed in ''prefix'' parameter. | ||
* [[MOR API hash construction | hash]] - SHA1 hash constructed using '''username''' and '''API_Secret_Key''' ([[MOR API hash construction | More described in Constructing hash]]). '''Required''' (if setting '''Disable hash checking''' is not checked). | * [[MOR API hash construction | hash]] - SHA1 hash constructed using '''username''' and '''API_Secret_Key''' ([[MOR API hash construction | More described in Constructing hash]]). '''Required''' (if setting '''Disable hash checking''' is not checked). | ||
<br><br> | <br><br> |
Latest revision as of 08:29, 13 September 2023
Description
MOR API rate_get feature enables you to check rate over http.
Admin able to check Rates of his Users.
Accountant with Permissions able to check Rates of Admins Users.
Reseller able to check Rates of his Users.
Note if Admin has checked Allow Resellers to use Admin Tariffs in API Configuration then using this API Reseller can get Rates which belongs to Admin.
Configuration
Go to SETTINGS –> Setup –> Settings
In API tab ensure that MOR API is enabled and check Allow devices to check rate over HTTP option :
Usage
- From MOR X4 call: /api/rate_get
- For Backwards-compatibility old name 'rate' is also usable. Call: /api/rate
- Methods: POST, GET(if allowed, not recomended)
Parameters
- u - username for authentication. From X5 - Required. If the u parameter is the username of a simple user, the global setting 'Show rates for users' must be enabled.
- username – username of the user whose rates you want to see.
- prefix – prefix number of the destination you want to see.
- by_full_dst - changes prefix parameter behavior. If parameter by_full_dst=1, then you can pass full numbers in prefix parameter and best matching rates will be returned. If parameter by_full_dst is not included, then MOR will return rate for the exact prefix passed in prefix parameter.
- hash - SHA1 hash constructed using username and API_Secret_Key ( More described in Constructing hash). Required (if setting Disable hash checking is not checked).
Request
HTML POST: http://<SERVER_IP>/billing/api/rate_get?u=admin&username=USERNAME&prefix=PREFIX&hash=HASH
Example:
http://127.0.0.1/billing/api/rate?u=admin&username=admin&prefix=370&hash=47fc73b6d374bd0a85e3984c1e1623451681569c
Returns
Success
Result is returned in format: rate#destination#prefix
<?xml version="1.0" encoding="UTF-8"?> <page> <rate>0.987#Lithuania#370</rate> </page>
NOTE. MOR API rate method shows rate, which is applied to User. If rate by prefix is not found in Custom Rates, it will be taken from Tariff assigned to User.
Errors
- User do not have rates for selected destination:
<?xml version="1.0" encoding="UTF-8"?> <page> <error>Rate was not found</error> </page>
- User with selected username does not exist:
<?xml version="1.0" encoding="UTF-8"?> <page> <error>User was not found</error> </page>
- Allow devices to check rate over HTTP option in API Settings is not set:
<?xml version="1.0" encoding="UTF-8"?> <page> <error>Feature disabled</error> </page>
- API is not allowed:
<?xml version="1.0" encoding="UTF-8"?> <status> <error>API Requests are disabled</error> </status>
- User does not belong to the user who is trying to check rate or it was not found in the system:
<?xml version="1.0" encoding="UTF-8"?> <status> <error>User was not found</error> </status>
- Accountant must have See Financial Data read or write permission and Manage Tariffs read or write permission enabled:
<?xml version="1.0" encoding="UTF-8"?> <status> <error>You are not authorized to view this page</error> </status>