Skip to main content

Authentication

Access token

Communication between clients and ITX servers is facilitated through an access token, comprising three essential components: tokenv2, rcntrl, and ccntrl. To access your access token in ITX, simply go to your user profile and click on the "Advanced" tab.

NameTypeDescription
tokenv2stringRandomly generated token
rcntrlintegerUser ID of the connected user
ccntrlintegerCorporation group

Usage

ITX offers two ways of authentication with your token; Query parameters or HTTP Headers.

Query parameters

To authenticate your session using query parameters, simply apply all three parts to the URL as shown below:

https://<endpoint>/rest/api/state?tokenv2=XXX&rcntrl=YYY&ccntrl=ZZZ

HTTP Headers

To authenticate your session using HTTP Headers, simply apply theese key-value pairs:

Header nameHeader value
tokenv2XXX
rcntrlYYY
ccntrlZZZ