Token Exchange

In order to communicate with the API you will require a token to be sent which is authenticated with the Cambrionix Connect platform. The token must be included with the Syntax in order for the endpoint to be accessed, if you do not have a valid token an error response will be received.

The token is provided by the Cambrionix Connect Authentication API within the Cambrionix Connect platform, more information on this can be found in the relevant user manual which can be downloaded from https://www.cambrionix.com/software.

Create a service

In order to get a token you will need to create a service within Cambrionix Connect with the relevant permissions for the API, information on the permissions can be found in the Cambrionix Connect user manual which can be downloaded from the following the browser application https://connect.cambrionix.com

Requesting a token

To request a token you will need to use the below HTTPS request and add in the parameters applicable to what you want the token to have permissions for, once you have a token you should save it as a variable to then add into the header as explained in the Call Structure section of this manual.

https://connect.cambrionix.com/api/v1/organizations/{organisation-id}/oauth2/token?audience={service-id}&grant_type=client_credentials&subject_token_type=urn:ietf:params:oauth:token-type:access_token&client_id={client-id}&client_secret={service-secret}&scope=permissions

Parameter	Description
organisation-id	The ID of the organisation you are using
service-id	The service ID obtained fromGet API DetailsAPI Details
client-id	The Id of the custom service
service-secret	The secret obtained from the custom service
permissions	The permissions required for the action, see the Cambrionix Connect user manual which can be downloaded from the following link cambrionix.com/products/cambrionix-connect/