/
Process to request token

Process to request token

 

Requesting a Token

Once you have an access key, you can request a token using the token REST API. A typical request includes these elements:

URL

HTTP Header:

Content-type:application/json
x-api-key: "<Access Key>"

The parameters in the HTTP header are described in this table.

Parameter

Description

Parameter

Description

x-api-key

The access key ID for which you want to generate a token. its unique for each partner

Request Body

The request body contains all URL parameters as JSON body

{
"userId" : "userId",
"file" : "fileId",
"server": "apiServerURL",
any other supported parameter, see Editor parameters | General Parameters
}

 

{     "file": "test.dwg",     "userId": "123" }

The file id is the just name of the file in S3. User id should be the real user id in production but can be any arbitrary id for testing.

 

Response

If successful, the service will return a 200 status code with the token and expiration time.

status: 200 Ok
{
"token": "bbf18f21-3d0d-4a4c-b650-9c14d4075ce0",
"expiration_time": 1595917409
}

On error, the service will return a 403 error code with a descriptive error message.

status: 403 Forbidden
{
Wrong token
}

Token validation

You can optionally validate a token with the verification endpoint

URL

HTTP Header

Content-type:application/json
x-api-token: token

The parameters in the HTTP header are described in this table.

Parameter

Description

Parameter

Description

x-api-token

token generated using /generate endpoint

Response

If successful, the service will return a 200 status code with all URL parameters which is passed using /generate endpoint

Status: 200 OK
{
"auth" : "appId",
"userId" : "userId",
"file" : "fileId",
"server": "apiServerURL",
any other supported parameter, see Editor parameters | General Parameters
}

On error, the service will return a 403 error code with a descriptive error message.

status: 403 Forbidden
{
Wrong token
}




 

Related content

API Server: Connecting ARES Kudo to a data backend
API Server: Connecting ARES Kudo to a data backend
More like this
Token Authentication
More like this
Accessing files in S3
Accessing files in S3
More like this
Onboarding ARES Kudo hosted by Graebert
Onboarding ARES Kudo hosted by Graebert
More like this