Autenticação "Basic Auth"

É possível fazer requisições para o SoftExpert Suite utilizando Basic Auth. Para fazer isso você precisa incluir o seguinte parâmetro em suas chamadas:

HEADER PARAMETER	VALUE
Authorization	Requerido Login e Password em Base64 do usuário de acesso válido seguindo o formato: Basic base64encode(<login>:<password>)

O exemplo a seguir retorna informações sobre um documento usando a API para recuperar informações sobre documentos do componente SoftExpert Documento "/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>" }'

Nos cabeçalhos da solicitação (HEADER), o cabeçalho Authorization passa à API uma cadeia de caracteres codificada em Base64 que representa seus valores de nome de usuário e senha, anexados ao texto da seguinte maneira: Basic

Basic <username:password>

perigo

Caso login ou senha usuário tenha sido alterado ou o respectivo usuário tenha sido bloqueado por algum motivo no SoftExpert Suite, todas as chamadas que o utilizam retornarão a seguinte mensagem: Valid GatewayJWT not found in the request or user is blocked!

As integrações existentes que utilizam a senha antiga do usuário não serão capazes de fazer solicitações bem-sucedidas contra as APIs e Web Services do SoftExpert Suite.

Se tudo estiver correto, você receberá uma resposta semelhante a esta:

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