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 | Description | Output parameters | Description |
---|---|---|---|
connection | The connection envelop | return | The token to use in all other API calls |
login | The login provided for API access | ||
pwd | The password API passwords expire after 365 days. | ||
key | The manager key copied from Actito. |
Error Descriptions
Status Code | Error Code | Error messages | Example Error Output |
---|---|---|---|
403 | Access 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> | |
404 | API_209 | No 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}