Authentication

See Also:  
Administrate Tokens in WATS Control Panel

General

All Api calls to WATS REST Api are secured and must be authenticated using basic authentication. To create a machine access token, login to your WATS web application and browse to the Token menu in Control panel.

Your tokens are like passwords. Keep them secret!

Authorization header

Once you have a valid token it can be used to query data. Just add the Authorization header to the request.

Authorization = Basic {token}

Example request with a valid Authorization header (using Postman)

 NOTE: If using Postman to test the endpoints, you should specify "No Auth" in the Authorization tab and add the Authorization header manually under Headers.

Get machine access token using the API

This functionality is deprecated

See End of support for provisioning tokens with GetToken rest API

A GetToken api call can be used to request a machine account token.

• Login to your WATS web application: https://yoursubdomain.wats.com
• Enter the following web address to request a new token: https://yoursubdomain.wats.com/api/Auth/GetToken/
• You may also specify a token identifier. The identifier should describe the purpose of your token: https://yoursubdomain.wats.com/api/Auth/GetToken/MyIdentifier
• You may reset a token with the reset flag: https://yoursubdomain.wats.com/api/Auth/GetToken/MyIdentifier?reset=true
  • Please note: In case you need to reset a token, every application configured with the “old token” will no longer be able to authenticate with the API.

 NOTE: It is recommended to administrate tokens using the Token menu in WATS Control panel.

Swagger

The WATS Rest API is documented and available in swagger as well. Login to you WATS web application and navigate to https://{your_server}/swagger

In swagger you can interact with API endpoints and lookup documentation.