Pular para o conteúdo principal
Versão: 2.2.2

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 PARAMETERVALUE
AuthorizationRequerido
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"
}
}
}
}