Get an authentication token

Overview

To authenticate Qredo API requests, you need to pass an authentication token as x-token in the request header. This guide explains how to get and refresh the token.

Prerequisites

Before you start, take these steps in the Qredo Web App:

1. Get an API key and secret.

2. Navigate to your Workspace and copy the Workspace ID from the URL:

   https://qredo.network/app/workspace/{workspaceID}
    Copy

Step 1: Get an auth token

You'll need an authentication token to authenticate Qredo API requests.

To get this token, call the Get a JWT authentication token endpoint with HMAC authentication based on your API secret:

GET https://api-v2.qredo.network/api/v2/workspaces/{workspaceID}/token
 Copy

You can use one of our code examples: the JavaScript example or the Postman example.

Follow the instructions before the preferred example to prepare it for usage. You'll need to specify your Workspace ID from Prerequisites and the API key and secret. Then run the example and copy the authentication token.

Step 2: Refresh your token

Your authentication token will expire in 1 hour. You can just generate a new one – see Step 1. Alternatively, you can refresh your token:

Call Refresh a JWT authentication token:

GET https://api-v2.qredo.network/api/v2/workspaces/{workspaceID}/token/refresh
 Copy

1. Query parameters:

   • Replace {workspaceID} with your Workspace ID from Prerequisites.
   • Replace {keyID} with the API key.

2. Authentication: Pass the auth token obtained in Step 1 as x-token in the request header.

3. Result: The endpoint will return a new token. Copy it and use to authenticate your requests.

What's next?

Now you're ready to use the Qredo API:

• Learn about the available endpoints: API reference
• Learn about different ways to approve transactions: Approve requests