Versions Compared

Old Version 24

changes.mady.by.user George Rossides

Saved on

compared with

New Version 25

changes.mady.by.user George Rossides

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxLevel2

...

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

...

POST authentication/token/release

Tip

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

...

Parameters

Name

Type

Description

token

(mandatory)

String

The authentication token which will be released

...

Expand
titleExample 1

HTTP Method: POST

 Request:

 

Post Data:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 {
  "token":"{{token}}"
}

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 {
  "status": {
    "message": "",
    "description": "",
    "code": "OK"
  },
  "data": {}
}

POST authentication/web_api_key/token

Tip

Available from CRM.COM R10.0.0

This method returns an authentication token which can subsequently be used by all other Web API method to access the system. Note that the authentication token expires after two hours. 

Note

Token expires after two hours, regardless of if the token is used or not, and a new one should be retrieved

Resource URL

Parameters

Name

Type

Description

keyStringThe key should be passed via HTTP Basic Auth, as the basic auth username. The basic auth password should be left empty

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 access CRM.COM. The token expires after two hours

Examples

Expand
titleExample 1

HTTP Method: POST

 Request:

Headers:

KeyValueComments
Content-Typeapplication/json 
AuthorizationBasic RUU3M0MwQUU2NDUyNDM3MUI1RERFRkY1RjdCQjIxOTI6Note that the Web API key for this example is EE73C0AE64524371B5DDEFF5F7BB2192, which is encrypted and set as the authorisation parameter based on the  HTTP Basic Auth protocol

 

Post Data:

Code Block
themeConfluence
languagejavascript
linenumberstrue
{
 
}

Response:

Code Block
themeConfluence
languagejavascript
linenumberstrue
 {
  "data": {
    "token": "1351195444"
  },
  "status": {
    "code": "OK",
    "description": "",
    "message": ""
  }
}