"Basic Auth" authentication

It is possible to send requests to SoftExpert Suite using Basic Auth. To do this, you need to include the following parameter in your calls:

HEADER PARAMETER	VALUE
Authorization	Required Login and password on Base64 of a valid access user following this format: Basic base64encode(<login> :<password>)

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 --location 'https://my-domain.softexpert.com/apigateway/v1/document/view' \
-H 'Authorization: Basic Y3RjYnI6U29mdEAxMjM=' \
-H 'Content-Type: application/json' \
-d '{ "iddocument": "<id_document>" }'

In the request headers (HEADER), the Authorization header passes on to the API a string encoded on Base64, which represents your username and password values, appended to the text as follows: Basic

Basic <username:password>

danger

If user login or password has been changed, or the user 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 performed by means of the user's old password 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"
      }
    }
  }
}