Tokens / Segurança

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

Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;
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

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

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?

Obtenha login de usuário da pessoa;
Obtenha o password (senha) da pessoa;
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

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

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?

Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;
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;
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

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

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:

AnteriorImportar e exportar aplicativos PróximoOutros

Atualizado há 1 ano