A API aqui descrita é a utilizada pela aplicação oficial da GIRA, pelo que é necessário iniciar sessão junto do serviço de autenticação da EMEL.
Os tokens expiram a cada 2 minutos e devem ser atualizados com refresh.
Clique para expandir
{
"Provider": "EmailPassword",
"CredentialsEmailPassword": {
"Email": "", // substituir pelos seus dados de acesso
"Password": "" // substituir pelos seus dados de acesso
}
}{
"error": {
"code": 0,
"message": "Success"
},
"data": {
"accessToken": "", // token JWT a usar nos pedidos para a API GIRA, expira 2 minutos após gerado
"refreshToken": "", // guardar token para atualizar o token expirado
"expiration": int // timestamp em ticks (referente ao accessToken)
}
}Pode descodificar o token JWT "accessToken" e saber mais sobre a norma JWT em JWT.io
Tick é uma unidade de tempo comumente utilizada em serviços baseados em .NET
1 tick = 10000 ms e a contagem inicia-se em 0001-01-01T00:00:00.0000000 UTC
Saiba mais sobre a unidade em https://learn.microsoft.com/en-us/dotnet/api/system.datetime.ticks
Em https://tickstodatetime.azurewebsites.net é possível a conversão instantânea para um formato human-readable.
Refresh URL: https://api-auth.emel.pt/token/refresh
Revoke URL: https://api-auth.emel.pt/token/revoke
{
"Token": "" //substituir pelo token a gerir
}GET https://api-auth.emel.pt/user
Deve incluir no corpo um objeto JSON formatado de acordo com a resposta obtida em Perfil
PUT https://api-auth.emel.pt/user
A API GIRA faz uso a linguagem de consulta GraphQL.
Obtenha o schema através de introspeção.
Deverá incluir um cabeçalho de autenticação do tipo Bearer, que contenha o valor da chave "accessToken" do JSON obtido em Autenticação:
Authorization: Bearer { accessToken }