Authenticating with the Data Catalogue API
You should authenticate requests to the Catalogue API using a Personal Access Token (PAT). This is a time-limited token which you can revoke if necessary.
Follow these steps to generate a PAT:
Click the user icon in the top-right of the Portal and select the Tokens menu.
Click GENERATE TOKEN.
Choose a name to describe the token’s purpose, and an expiration date, then click CREATE.
Copy the token and store it in a secure place.
|You won’t be able to retrieve your token from the Portal once you’ve created it, so make sure to take a copy.|
|Treat your tokens like passwords and keep them secret. When working with the API, use tokens as environment variables instead of hardcoding them into your programs.|
Make sure you accompany each request to the API with an
Authorization header using your PAT as a bearer token, as follows:
Authorization: bearer <token>
<token> with your Personal Access Token. For example, if you’re using curl on the command line, you can set the header using the
curl -H "Authorization: bearer <token>" ...
If you fail to send a valid Authorization header, the API will respond with a