Skip to main content

Open Connection

This method provides a session token when given valid credentials.

info

The token is valid for 60 minutes. If there is a period of inactivity for 30 consecutive minutes at any point after opening the connection, the token will expire and the connection will close automatically.

This is a GET method.

REST WADL

https://atmp-pub-api-www3.actito.com/apinmpreporting/application.wadl

REST URL

https://atmp-pub-api-www3.actito.com/apinmpreporting/connection
Input parameters
Required parameters
DescriptionOutput parametersDescription
connectionThe connection envelopreturnThe token to use in all other API calls
loginThe login provided for API access
pwdThe password
API passwords expire after 365 days.
keyThe manager key copied from Actito.

Error Descriptions

Status CodeError CodeError messagesExample Error Output
403Access denied.
You must fill in the managerKey parameter to authentificate on this API
You must fill in the password paramter to authentificate on this API.
Please enter a valid token to validate your connection.
Your session has expired due to timeout
<?xml version="1.0" encoding="UTF-8" standalone="yes"?><ExceptionEntity><errorMessage>Access denied.</errorMessage></ExceptionEntity>
404API_209No result found<?xml version="1.0" encoding="UTF-8" standalone="yes"?><ExceptionEntity><errorCode>API_209</errorCode><errorMessage>No result found</errorMessage></ExceptionEntity>

REST Example

Input

XML Input

URL

https://atmp-pub-api-www3.actito.com/apinmpreporting/connection

Header

content-type application/xml
accept application/xml

Body

<connection>
<login>{login}</login>
<pwd>{password}</pwd>
<key>{key}</key>
</connection>

JSON Input

URL

https://atmp-pub-api-www3.actito.com/apinmpreporting/connection

Header

content-type application/json
accept application/json

Body

{
"login": "{login}",
"pwd": "{password}",
"key": "{key}"
}

Output

{token}