POST authentication/token

This method returns an authentication token which can subsequently be used by all other Web API method to access the system.

Token expires every one (1) hour and a new one will need to be retrieved

Resource URL

Parameters

Name	Type	Description
username (mandatory)	String	The username that should be used to login.
password (mandatory)	String	The password that should be used to login.
organisation (mandatory)	String	The organization on which the user will login
unit (optional)	String	The unit ID that the user will use during login. If not specified then the default unit for that user is used

Response Data

Name	Type	Description
token	String	The authentication token which can be used to login

Examples

Example 1

HTTP Method: POST

Request:

Post Data:

{
    "username": "mpadministrator",
    "password": "1234",
    "organisation": "CRMDEMO",
    "unit": "EE63A82C4FEBE02FF34E90DD1EBA5ABE"
}

Response:

{
    "status": {
        "code": "OK",
        "message": null,
        "description": null
    },
    "data": {
        "token": "4AD9C84FA60F9FE407140E20F707726A"
    }
}

POST authentication/token/release

Available from CRM.COM R10.0.0

This method releases an authentication token in order to make it not usable by any other subsequent Web API calls

Token expires every one (1) hour and a new one will need to be retrieved. It is recommended to release tokens if there are not needed any more

Resource URL

Parameters

Name

Type

Description

token

(mandatory)

String

The authentication token which will be released