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

userIdinteger · int32Opcional

Identificador da pessoa

usernamestringOpcional

Nome da pessoa

temporaryTokenstringOpcional

Token temporário que representa a pessoa autenticada

400

Solicitação ou dados da solicitação são inválidas

401

Pessoa não autorizada

403

Pessoa não tem permissão de executar essa operação

404

O registro não foi encontrado

429

Muitas requisições em um determinado período de tempo

500

Ocorreu algum erro interno no servidor

get/api/2/tokens

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

Node.js

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

userIdinteger · int32Opcional

Identificador da pessoa

namestringOpcional

Nome da pessoa

usernamestringOpcional

Login da pessoa

temporaryTokenstringOpcional

Token temporário que representa a pessoa autenticada

400

Solicitação ou dados da solicitação são inválidas

401

Pessoa não autorizada

403

Pessoa não tem permissão de executar essa operação

404

O registro não foi encontrado

429

Muitas requisições em um determinado período de tempo

500

Ocorreu algum erro interno no servidor

post/api/2/tokens

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

Node.js

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

AuthorizationstringObrigatório

Utilize um token válido de usuário para realizar a requisição

Parâmetros de rota

userIdinteger · int32Obrigatório

Código da pessoa a ser personificada

Respostas

200

Sucesso

400

Solicitação ou dados da solicitação são inválidas

401

Pessoa não autorizada

403

Pessoa não tem permissão de executar essa operação

404

O registro não foi encontrado

429

Muitas requisições em um determinado período de tempo

500

Ocorreu algum erro interno no servidor

get/api/2/tokens/impersonate/{userid}

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

AuthorizationstringObrigatório

Utilize um token válido de usuário para realizar a requisição

Parâmetros de rota

usernamestringObrigatório

Username da pessoa a ser personificada

Respostas

200

Sucesso

400

Solicitação ou dados da solicitação são inválidas

401

Pessoa não autorizada

403

Pessoa não tem permissão de executar essa operação

404

O registro não foi encontrado

429

Muitas requisições em um determinado período de tempo

500

Ocorreu algum erro interno no servidor

get/api/2/tokens/impersonate/{username}

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

Node.js (utilizando userId)

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);
};

Node.js (utilizando username)

let userName = 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/${userName}` requestOptions);
  const result = await response.text();
  console.log(result)
} catch (error) {
  console.error(error);
};

---

Links relacionados:

• O que é preciso para fazer integrações do Zeev para outros sistemas?

• Como autenticar nas APIs do Zeev

• Como controlar o volume máximo de requisições à APIs

• Como acessar o Swagger / OpenAPI