Redistribution partners need to authenticate their calls to the REST service.
First, you will need to make a HTTP
GET call to the
/authenticate endpoint, providing a username and password which will have been given to you by DeltaXML. This endpoint uses HTTP Basic Auth.
The response will include an Authorization header containing a JWT, e.g.:
This JWT will last for 12 hours and will need to be included in subsequent requests to other endpoints. For example, calling
/pipelines to get pipeline info:
You should re-call the
/authenticate endpoint to get a new token when the current one has expired.
A special collection for redistribution customers is available for testing using Postman.
Click this button to import the Collection to Postman:
The collection is available from the sidebar under "Collections":
To use this Collection you will first need to use the "Request Token" request (under the folder "Authentication"). Under "Authentication" should a screen stating it is using Basic Auth.
Please enter your provided username and password then hit "Send".
Make a copy of the JWT returned - the text after "Bearer " (under "Headers" in the Response window)
Click on the "..." ellipses on the Collection (or right-click) then press "Edit"
Navigate to the "Authorization" menu at the top then enter your token in the "Token" field:
You'll need to get a new token every 12 hours, so re-follow the steps from requesting the token using the "Request Token" request.
Command Line Client
The JAR file "deltaxml-rest-client-x.y.z.jar" provides similar functionality to our standard command-line app. (Replace x.y.z with the major.minor.patch version number of your release as shown below)
To authenticate with the REST API from this client, use the parameter authenticate then provide your username and password, for example:
The client will store the JWT in a file called
.deltaxml-rest-client-token, and automatically use it in subsequent requests.
As with the Postman Collection, you will need to re-call authenticate every 12 hours to obtain a new token.