Login request

Before issuing any requests, client applications must perform a user authentication dialog with our servers. The login process authenticates the user account and provides the level of service and feature access associated with the account. A successful login returns the 200 OK message followed by a list of authorizations for the account. Error messages are returned for failed logon attempts.

Request URL

http://api.kibot.com?action=login&user=[username]&password=[password]

Response

After successful login, the server returns 200 OK followed by the list of authorizations. If any of the required parameters is missing or incorrect, the following generic error message is displayed: "401 Unauthorized. Login Failed".

Here is an example of a successful login operation:

200 OK

Authorizations

=====================

Russell 3000,1/1/1998,1

Parameters

The table below describes all the parameters that are accepted:

PARAMETER	DESCRIPTION	REQUIRED	POSSIBLE VALUES
action	Specifies the server command to perform	YES	login
user	Specifies the user name or e-mail address	YES	User name or e-mail address guest
password	Specifies the password assigned to the account	NO	Password May be omitted for guest account

Remarks

Use the login information provided to you after your initial purchase. The server keeps track of the products you have purchased and allows you to download data for which you are authorized.

The time out interval for user sessions is set to 20 minutes. You can keep your session alive and prevent frequent login operations by calling the Status command.

Number of concurrent requests from more than one IP address are tracked and restricted. Guest accounts are allowed to download only certain amount of daily (end of day) historical data.