Tokens / Segurança

Como obter os dados e o token temporário da pessoa autenticada na API?

  1. Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;

  2. Enviar requisição: Enviar a requisição para o endpoint Tokens / Segurança;

Obter o dados e token temporário da pessoa autenticada atualmente (Auth)

get
Respostas
200

Sucesso

get
GET /api/2/tokens HTTP/1.1
Host: seu_endereco.do.zeev
Accept: */*

{
  "userId": 1,
  "username": "text",
  "temporaryToken": "text"
}

Exemplo de requisição para obter os dados e o token temporário do usuário autenticado

const myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer TOKEN_DO_USUARIO");

const requestOptions = {
  method: "GET",
  headers: myHeaders
};

try {
  const response = await fetch("https://seu_endereco.do.zeev/api/2/tokens", requestOptions);
  const result = await response.text();
  console.log(result)
} catch (error) {
  console.error(error);
};

Como obter token temporário de autenticação com usuário e senha utilizando API?

  1. Obtenha login de usuário da pessoa;

  2. Obtenha o password (senha) da pessoa;

  3. Envie a requisição: Utilize o endpoint Tokens / Segurança para enviar a requisição. Lembre-se de trocar seu_endereco.do.zeev pelo endereço que você utiliza para acessar o Zeev;

Obter token temporário a partir de usuário e senha

post
Corpo
loginstringObrigatório
passwordstringObrigatório
Respostas
200

Sucesso

post
POST /api/2/tokens HTTP/1.1
Host: seu_endereco.do.zeev
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "login": "text",
  "password": "text"
}
{
  "userId": 1,
  "name": "text",
  "username": "text",
  "temporaryToken": "text"
}

Exemplo de requisição para obter obter token temporário de autenticação 

const myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer TOKEN_DO_USUARIO");

const raw = JSON.stringify({
  "login": "jhonny.madson",
  "password": "M1nh4S3nh4-D0Z33v"
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw
};

try {
  const response = await fetch("https://seu_endereco.do.zeev/api/2/tokens", requestOptions);
  const result = await response.json();
  console.log(result)
} catch (error) {
  console.error(error);
};

Como personificar e obter token temporário de outra pessoa utilizando API?

  1. Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;

  2. Obtenha o userId ou o username: Obtenha o código identificador ou o login do usuário que deseja assumir. Podem ser obtidos na página Acesso > Pessoas ou através de consultas de API como descrito em Listar pessoas;

  3. Envie a requisição para:

    1. Tokens / Segurança se desejar utilizar o código identificador da pessoa;

    2. Tokens / Segurança se deseja utilizar o login de usuário da pessoa;

Lembre-se de substuir seu_endereco.do.zeev pelo endereço que você utiliza para acessar o Zeev.

Personificar e obter o token temporário de outra pessoa a partir de seu código (Auth)

get
Autorizações
Parâmetros de rota
userIdinteger · int32Obrigatório

Código da pessoa a ser personificada

Respostas
200

Sucesso

get
GET /api/2/tokens/impersonate/{userid} HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*

{
  "current": {
    "id": 1,
    "name": "text",
    "username": "text",
    "temporaryToken": "text"
  },
  "impersonate": {
    "id": 1,
    "name": "text",
    "username": "text",
    "temporaryToken": "text"
  }
}

Personificar e obter o token temporário de outra pessoa a partir de seu username (Auth)

get
Autorizações
Parâmetros de rota
usernamestringObrigatório

Username da pessoa a ser personificada

Respostas
200

Sucesso

get
GET /api/2/tokens/impersonate/{username} HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*

{
  "current": {
    "id": 1,
    "name": "text",
    "username": "text",
    "temporaryToken": "text"
  },
  "impersonate": {
    "id": 1,
    "name": "text",
    "username": "text",
    "temporaryToken": "text"
  }
}

Exemplos de como personificar e obter o token temporário de outro usuário

let userId = 753;

const myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer TOKEN_DO_USUARIO");

const requestOptions = {
  method: "GET",
  headers: myHeaders
};

try {
  const response = await fetch(`https://seu_endereco.do.zeev/api/2/tokens/impersonate/${userid}` requestOptions);
  const result = await response.text();
  console.log(result)
} catch (error) {
  console.error(error);
};

Links relacionados:

AnteriorImportar e exportar aplicativosPróximoOutros

Atualizado