Difference between revisions of "MOR API user login"
From Kolmisoft Wiki
Jump to navigationJump to search
(→Usage) |
|||
Line 6: | Line 6: | ||
* Call: /api/user_login | * Call: /api/user_login | ||
* For Backwards-compatibility old name 'login' is also usable. Call: /billing/api/login | |||
* Methods: POST, GET(if allowed, not recomended) | * Methods: POST, GET(if allowed, not recomended) | ||
<br><br> | <br><br> |
Revision as of 15:04, 23 May 2013
Description
MOR API Logs in user into MOR
Usage
- Call: /api/user_login
- For Backwards-compatibility old name 'login' is also usable. Call: /billing/api/login
- Methods: POST, GET(if allowed, not recomended)
Parameters
- u - username to login. Required.
- p - Password to login. Required.
Request
HTML POST: http://<SERVER_IP>/billing/api/user_login?u=username&p=password
Returns
Success. Everything is ok. User is logged into the system you get:
<?xml version="1.0" encoding="utf-8" standalone="yes"?> <action> <name>login</name> <status>ok</status> <user_id>user_id</user_id> #this line was added on MOR11 <status_message>Successfully logged in</status_message> </action>
Error
<?xml version="1.0" encoding="utf-8" standalone="yes"?> <action> <name>login</name> <status>failed</status> <status_message>Login failed</status_message> </action>
This means that wrong username and/or password and user can't be authenticated.
Advanced options
To redirect customer to MOR Billing main site go to: SETTINGS -> Setup -> Settings -> API and check the marked option:
If login over API is successful the customer will be redirected to MOR Billing main site.
If login is not successful :
<?xml version="1.0" encoding="utf-8" standalone="yes"?> <action> <name>login</name> <status>failed</status> </action>
This means that wrong username and/or password and user can't be authenticated.