Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Tip
titleThis is a section of API to provide access to registration, customer login and account access.

It is highly recommended to use HTTPS to access this part of API.

Table of Contents




Customer Login or authentication confirmation

This API request needs to be done every time customer request to login to get access to customer account or just to confirm that current authentication is still valid and not expired.

Route: a/account/login

Method: POST


Panel


ParameterMeaningNotes
callbackA JavaScript function to run when the response is receivedOptional parameter allows you to specify a JavaScript function to handle query results for pure client-side implementations.

Embed the API query in <script> tags. Define the callback function in <script> tags.

email or loginnameemail address or loginname registered in customer accountImportant: If "Require Login Name” is enabled (default), email based login will not work. This param is required for initial login.
passwordcustomer’s passwordThis param is required for initial login
tokenAccess token ID. This token is provided by the system after successful initial authenticationrequired to confirm established authentication
api_keyUnique API key that is set in the control panelThis is optional key that can be set to limit unauthorized (accidental) access to your API


Example logon request:
POST: rt=a/account/login , loginname=testlogin , password=123456789


Code Block
languageactionscript3
themeDJango
titleExample response: Success
linenumberstrue
{"status":1,"success":"Logged in","token":"58fb1592f0c59b8dc1d5541aebdff8da"}


Code Block
languageactionscript3
themeDJango
titleExample response: Fail
linenumberstrue
{"status":0,"error":"Login attempt failed!"}

Example authentication check request:

POST: rt=a/account/login , token=58fb1592f0c59b8dc1d5541aebdff8da


Code Block
languageactionscript3
themeDJango
titleExample response:
linenumberstrue
{
   "status":1,
   "request":"authorized"
}



Account Logout

Simple log out request. Token needs to be disregarded from future use.

Route: a/account/logout

Method: POST


Panel


ParameterMeaningNotes
callbackA JavaScript function to run when the response is receivedOptional parameter allows you to specify a JavaScript function to handle query results for pure client-side implementations.

Embed the API query in <script> tags. Define the callback function in <script> tags.

tokenAccess token ID. This token is provided by the system after successful initial authenticationrequired
api_keyUnique API key that is set in the control panelThis is optional key that can be set to limit unauthorized (accidental) access to your API


Example request:
POST: rt=a/account/logout , token=58fb1592f0c59b8dc1d5541aebdff8da

Code Block
languageactionscript3
themeDJango
titleExample response:
linenumberstrue
{
   "status":1,
   "success":"Logged out"
}



Customer Account Details

Get basic customer Details.

Route: a/account/account

Method: POST


Panel


ParameterMeaningNotes
callbackA JavaScript function to run when the response is receivedOptional parameter allows you to specify a JavaScript function to handle query results for pure client-side implementations.

Embed the API query in <script> tags. Define the callback function in <script> tags.

tokenAccess token ID. This token is provided by the system after successful initial authenticationrequired
api_keyUnique API key that is set in the control panelThis is optional key that can be set to limit unauthorized (accidental) access to your API