Skip to main content

Autenticação

Para utilização das APIs é necessário enviar o token em todas as requisições, garantindo assim a segurança e a identificação do usuário logado.

Criando um token​

Dica

O mesmo token pode ser utilizado em várias requisições até atingir seu tempo de expiração. Fazendo isso, você terá uma melhor performance na integração do seu sistema com a Funcional.

Parâmetros​

ParâmetroTipoObrigatórioDescrição
loginStringSimLogin do usuário
passwordStringSimSenha do usuário

Para criar um token, chame a mutation createToken passando as credenciais do usuário.

Exemplo de requisição​

mutation {
  createToken(
      login: "usuario_exemplo"
      password: "senha_exemplo"    
  ) {
    code
    message
    status
    data {
      token
      errors {
        message
      }
    }
  }
}

Exemplo de resposta​

{
  "data": {
    "createToken": {
      "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.exemplo.token.ficticio"
    }
  }
}

Utilizando o token​

Envie o token no elemento Authorization do header da requisição HTTPS.
O mesmo token pode ser utilizado em várias requisições até a sua expiração.

Exemplo:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.exemplo.token.ficticio

Expiração de um token​

O token tem validade de 1 hora.
Caso seja enviado um token expirado, será retornado um erro na chamada