Requests sent to version 3 of our web services are secured using a Json Web Tokens (JWT). Please contact your Account Manager to obtain your client credentials.How to obtain a JWT Token#
JWT tokens are obtained by sending a request to the /auth/connect/token endpoint passing it the client id and client secret in the request body. For example:Your client id and secret should be URL EncodedIf authenticated successfully, an object is returned in the response with the property access_token being the JWT token.{
"access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI...",
"token_type": "Bearer",
"expires_in": 3599,
"scope": "shipments.view"
}
How to use the JWT Token#
The JWT token can be used for Bearer Authentication. It's passed in the
Authorization header as the following:Client Ref Number#
In version 2 of our web services, a ClientRefNum
value was passed in the AuthenticationData
object in the request body.To use this same functionality in version 3, you can simply pass the same value in your token request. For example:This will associate the returned access_token to the specified client and any actions in the system will be associated to that client.OAuth 2.0#
Modified at 2024-12-04 18:04:57