Skip to main content
Version: 2.2.2

"JWT Token" API key authentication

caution

  Prerequisites:
This guide assumes you already know how to locate an API key in the User account.

The API key allows you to make requests to SoftExpert Suite. To do this, you need to include the following parameter in your calls:

HEADER PARAMETERVALUE
AuthorizationRequired
Valid JWT access token following this format: <Token JWT>

The following example returns information about a document using the API to retrieve information about documents from the SoftExpert Document component "/v1/document/view":

curl 'https://my-domain.softexpert.com/apigateway/v1/document/view' \
-H 'Authorization: <your_api_token>' \
-H 'Content-Type: application/json' \
-d '{ "iddocument": "<id_document>" }' -X POST
danger

If the API key has been changed, or the user associated with the token has been locked out of SoftExpert Suite for some reason, all calls using said user will return the following message:Valid GatewayJWT not found in the request or user is blocked!

Existing integrations using the old token will not be able to send successful requests to the SoftExpert Suite APIs and web services.

If everything is correct, you will receive a response similar to this one:

{
"return": {
"IDDOCUMENT": "0022511",
"NMTITLE": "Drawing 0022511",
"IDCATEGORY": "SD",
"NMCATEGORY": "Steel Detailing",
"STATUS": "2",
"NRHITS": "3",
"NMAUTHOR": "Tetsuo Kendo",
"IDREVISION": "00",
"DTDOCUMENT": "8/21/2015",
"URL": "",
"LINKSHARE": " ",
"ATTRIBUTTES": {
"item": [
{
"ATTRIBUTTENAME": "006",
"ATTRIBUTTEVALUE": ""
},
{
"ATTRIBUTTENAME": "CID",
"ATTRIBUTTEVALUE": ""
},
{
"ATTRIBUTTENAME": "CCN",
"ATTRIBUTTEVALUE": {
"document": ""
}
},
{
"ATTRIBUTTENAME": "SR",
"ATTRIBUTTEVALUE": {
"document": ""
}
},
{
"ATTRIBUTTENAME": "PS",
"ATTRIBUTTEVALUE": {
"document": "A4"
}
},
{
"ATTRIBUTTENAME": "Country",
"ATTRIBUTTEVALUE": {
"document": "Brazil"
}
},
{
"ATTRIBUTTENAME": "City",
"ATTRIBUTTEVALUE": {
"document": ""
}
}
]
},
"ELECTRONICFILE": {
"item": {
"FILENAME": "AcU-2.DES-2.9000-19-SDT-201 rev.B.dwg"
}
}
}
}