Gerenciar grupos de manutenção da pessoa
Como consultar os grupos de manutenção vinculados à uma pessoa utilizando API?
Para consultar os grupos atribuídos a uma pessoa, siga os passos abaixo:
Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;
Obtenha o userid: Obtenha código do usuário. É possível obter este identificador na página Acesso > Pessoas ou utilizando consulta de API's como nos exemplos que estão disponíveis em Como listar os dados de cadastro de todas as pessoas utilizando API do Zeev?.
Enviar a Requisição: Utilize o endpoint Gerenciar grupos de manutenção da pessoa para enviar a requisição conforme modelo e exemplo (troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev).
oData: opcionalmente, utilize regras oData para manipular o resultado da API. Essa API aceita
$filter,$select,$orderbye$top.
Código identificador da pessoa
Sucesso.
Solicitação ou dados da solicitação são inválidas
Pessoa não autorizada
Pessoa não tem permissão de executar essa operação
O registro não foi encontrado
Muitas requisições em um determinado período de tempo
Ocorreu algum erro interno no servidor
GET /api/2/users/{userid}/groups HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*
[
{
"id": 1,
"title": "text"
}
]Exemplo de requisição para obter os grupos de uma pessoa utilizando API:
let userId = 951;
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/users/${userId}/groups`, requestOptions);
const result = await response.json();
console.log(result)
} catch (error) {
console.error(error);
};Como adicionar um grupo de permissão à uma pessoa utilizando API?
Se você deseja atribuir dois ou mais grupos a uma pessoa, considere utilizar o endpoint de cadastro, especificando a lista de funções com o valor de ifExists igual a update. ver mais em como cadastrar pessoas no Zeev, utilizando API.
Para adicionar um grupo a uma pessoa no Zeev utilizando API, siga os passos abaixo:
Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;
Obtenha o userid: Obtenha código do usuário. É possível obter este identificador na página Acesso > Pessoas ou utilizando consulta de API's como nos exemplos que estão disponíveis em Listar pessoas;
Obtenha o groupId: Obtenha o código identificador da função, disponível no Zeev na página Avançado > Grupos de acesso ou através de consultas de API como as que estão disponíveis emGrupos de manutenção;
Enviar a Requisição: Utilize o endpoint Gerenciar grupos de manutenção da pessoa para enviar a requisição conforme modelo e exemplo (troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev):
Código identificador da pessoa
Código identificador do grupo
Sucesso.
Solicitação ou dados da solicitação são inválidas
Pessoa não autorizada
Pessoa não tem permissão de executar essa operação
O registro não foi encontrado
Muitas requisições em um determinado período de tempo
Ocorreu algum erro interno no servidor
POST /api/2/users/{userid}/groups/{groupid} HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*
{
"success": true,
"userId": 1,
"groupId": 1
}Exemplo de requisição para adicionar grupo de permissão a uma pessoa:
let userId = 456;
let groupId = 852;
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: "POST"
};
try {
const response = await fetch(`https://seu_endereco.do.zeev/api/2/users/${userId}/groups/${groupId}`, requestOptions);
const result = await response.text();
console.log(result)
} catch (error) {
console.error(error);
};Como remover um grupo de manutenção de uma pessoa utilizando API?
Para remover um grupo de acesso de uma pessoa, siga os passos abaixo:
Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;
Obtenha o userid: Obtenha código do usuário. É possível obter este identificador na página Acesso > Pessoas ou utilizando consulta de API's como nos exemplos que estão disponíveis em Listar pessoas;
Obtenha o groupId: Obtenha o código identificador da função, disponível no Zeev na página Avançado > Grupos de acesso ou através de consultas de API como as que estão disponíveis emGrupos de manutenção;
Enviar a Requisição: Utilize o endpoint Gerenciar grupos de manutenção da pessoa para enviar a requisição conforme modelo e exemplo (troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev):
Código identificador da pessoa
Código identificador do grupo
Sucesso.
Solicitação ou dados da solicitação são inválidas
Pessoa não autorizada
Pessoa não tem permissão de executar essa operação
O registro não foi encontrado
Muitas requisições em um determinado período de tempo
Ocorreu algum erro interno no servidor
DELETE /api/2/users/{userid}/groups/{groupid} HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*
Sem conteúdo
Exemplo de requisição para remover um grupo de uma pessoa:
let userId = 456;
let groupId = 852;
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: "DELETE",
headers: myHeaders
};
try {
const response = await fetch(`https://seu_endereco.do.zeev/api/2/users/${userId}/groups/${groupId}`, requestOptions);
const result = await response.text();
console.log(result)
} catch (error) {
console.error(error);
};Como copiar grupos de manutenção de uma pessoa para outra utilizando API?
Para copiar os grupos de acesso de uma pessoa para outra utilizando API siga os passos abaixo:
Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;
Obter os parâmetros: O parâmetro userid é o código identificador da pessoa de quem se deseja copiar as funções o newuserid é o código identificador da pessoa a quem se deseja atribuir as funções. Ambos podem ser obtidos na página do Zeev Acesso > Pessoas, ou através de consultas de API como nos exemplos disponíveis em Listar pessoas;
Enviar a Requisição: Utilize o endpoint Gerenciar grupos de manutenção da pessoa para enviar a requisição conforme modelo e exemplo (troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev):
Código identificador da pessoa de origem
Código identificador da pessoa de destino
Sucesso.
Solicitação ou dados da solicitação são inválidas
Pessoa não autorizada
Pessoa não tem permissão de executar essa operação
O registro não foi encontrado
Muitas requisições em um determinado período de tempo
Ocorreu algum erro interno no servidor
POST /api/2/users/{userid}/groups/copy/{newuserid} HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*
{
"success": true,
"from": 1,
"to": 1
}Exemplo de requisição para copiar os grupos de acesso de uma pessoa para outra:
let userId = 741;
let newUserId = 963;
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: "POST",
headers: myHeaders
};
try {
const response = await fetch(`https://seu_endereco.do.zeev/api/2/users/${userId}/groups/copy/${newUserId}`, requestOptions);
const result = await response.text();
console.log(result)
} catch (error) {
console.error(error);
};Links relacionados:
Atualizado