Content Comparison

...

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

POST : https://tokens.kudo.graebert.com/generate

headersHTTP Header:

Content-type:application/json

...

x-api-key: "<Access Key>"

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

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 https://graebert.atlassian.net/wiki/spaces/KUDOPARTNER/pages/1180008643/Editor+parameters#General-Parameters
}

Expand

title	Example to open a file from S3:

Code Block
{ "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
}

You can optionally validate a token with the verification endpoint

URL

GET: https://tokens.kudo.graebert.com/verify

HTTP Header

Content-type:application/json

...

x-api-token: token

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

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 https://graebert.atlassian.net/wiki/spaces/KUDOPARTNER/pages/1180008643/Editor+parameters#General-Parameters
}

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

status: 403 Forbidden
{
Wrong token
}