Difference between revisions of "MOR API user balance update"
From Kolmisoft Wiki
Jump to navigationJump to search
Line 30: | Line 30: | ||
*If the balance is changed during the call, price for the call will be deducted from new balance, because balance is deducted at the end of call. | *If the balance is changed during the call, price for the call will be deducted from new balance, because balance is deducted at the end of call. | ||
<br><br> | <br><br> | ||
---- | |||
*Example: | |||
**We have user_id = 123, API Secret Key = 456789, balance = 100 | |||
**Hash string to be converted: "123100456789" | |||
**We send: | |||
***/api/user_balance_change?u=admin&p=admin&user_id=123&balance=100&hash=b1bef44691c237b574263e09b2838ad1e658e507 | |||
'''* Note that username and password are not included in hash''' |
Revision as of 14:08, 22 December 2011
This functionality is available from MOR 10
Login and change user balance.
- Call: /api/user_balance_change
- Methods: POST, GET(if allowed, not recomended)
- Params:
- user_id - Users ID in MOR database, whose balance we want to change. Required.
- u - username to login. Required.
- p - password to login. Required.
- balance - new user balance. Required.
- hash - SHA1 hash constructed using user_id, balance and API_Secret_Key ( More described in Constructing hash). Required.
- Returns:
- 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>Bad login</error> - User not loged in the system. Check username and password.
- <error>User balance not updated</error> - Params balance is not correct or user is not saved. Check balance param.
- Errors:
Additional notes
- If the balance is changed during the call, price for the call will be deducted from new balance, because balance is deducted at the end of call.
- Example:
- We have user_id = 123, API Secret Key = 456789, balance = 100
- Hash string to be converted: "123100456789"
- We send:
- /api/user_balance_change?u=admin&p=admin&user_id=123&balance=100&hash=b1bef44691c237b574263e09b2838ad1e658e507
* Note that username and password are not included in hash