STCP Directlink
API Rest
Obter token OAuth2

Token de autorização

Esta requisição deve ser utilizada para obter o token(bearer) de autorização de acesso as funções da plataforma.


POST 
https://your-domain/directlink/v1/oauth2/token

OAuth2 token

Esta requisição deve ser utilizada para obter o token de autorização

Atenção

* Parâmetro obrigatório

Parameters

Header

Chave Tipo Valor
Content_type * password application/x-www-form-urlencoded

Body

Nome Descrição
grant_type * password
username * nome do usuário na plataforma
password * senha do usuário na plataforma


O campo body, deve ser formatado em query string como exemplo: grant_type=password&username=usuario&password=senha

Responses


200 OK
Successo
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwOi8vMTkyLjE2OC41LjM4OjgwODAvZGlyZWN0bGluay92MSIsInN1YiI6IlVTRVIxIiwiYXVkIjpbImh0dHA6Ly8xOTIuMTY4LjUuMzg6ODA4MC9kaXJlY3RsaW5rL3YxIl0sImV4cCI6MTY1NTE1OTk3NiwibmJmIjoxNjU1MTU2Mzc2LCJpYXQiOjE2NTUxNTYzNzYsImp0aSI6IjE2NTUxNTYzNzY0Mjg2OTcwMDAifQ.GeMf9voddvEdgStH2GJqHIKIWXXYYbhLEKVz-kq_Cp8",
"token_type": "Bearer",
"expires_in": 3600,
"scope": "https://your-domain/directlink/v1"
}

400 Bad Request
Parâmetros da requisição inválidos
{
    "error": 400,
    "error_description": "Bad Request",
    "error_uri": "https://your-domain/directlink/v1"
}

401 Unauthorized
Usuário não existe ou senha inválida 
{
    "error": 401,
    "error_description": "Unauthorized",
    "error_uri": "https://your-domain/directlink/v1"
}

500 Internal Server Error
Falha interna 
{
    "error": 500,
    "error_description": "Internal server error",
    "error_uri": "https://your-domain/directlink/v1"
}

A solicitação do token de autorização para acesso as interfaces disponíveis utiliza o padrão oauth2, Resource Owner Password Credential Grant (Autorização para o proprietário do recurso).

Requisição (exemplo) 

POST /token HTTP/1.1
Host: server.example.com
Content-Type: application/x-www-form-urlencoded

grant_type=password&username=johndoe&password=A3ddj3w

Resposta (exemplo) 

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache
{
       "access_token":"2YotnFZFEjr1zCsicMWpAA",
       "token_type":"Bearer",
       "expires_in":3600,
       "scope":"example_value"
}
Login