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}