Example API Requests

Postman

  1. Open Postman and create a new POST request.
  2. Enter the Security Administration URL for the token method: https://localhost/STS/connect/token
  3. Click the Headers tab.
  4. Add a key named Content-Type with the value application/x-www-form-urlencoded.
  5. Add a key named WKFS-ClientCertificate with the value of the Base64 encoded cert created above.
  6. Click the Body tab.
  7. Click the x-www-form-urlencoded button.
  8. Add a key named grant_type with the value client_credentials.
  9. Add a key named client_id with the value of the Client ID created in Security Administration.
  10. Add a key named scope with the value of the scopes added to the database. Separate the scopes with spaces.
  11. Click Send.
  12. You will receive a response containing an access_token. Copy this token to the clipboard and use it as the Bearer token to your requests to DGS Core, EZ Config Packages and Packets, or EZ Config Default Data.

SoapUI

  1. Open SOAP UI.
  2. Create a new REST Project.
  3. Enter the Security Administration URI: https://localhost/STS/connect/token in the dialog.
  4. Change the Method to POST.
  5. Add a new request parameter named grant_type with the value client_credentials.
  6. Add a new request parameter named client_id with the value of the Client ID from Security Administration.
  7. Add a new request parameter named scope with the value of the scope for this client (i.e. wk-ezcfg-def-data-read).
  8. Check the Post QueryString checkbox.
  9. Click the Headers tab on the bottom left.
  10. Add a new Header with the name WKFS-ClientCertificate and the value being the base64 encoded certificate you created previously.
  11. Click the green play button.
  12. Click the JSON tab in the response window to view the JSON response and see the access token value.