Transferir propriedade de dados entre pessoas

Como transferir as propriedades de dados de uma pessoa para outra utilizando API?

Utilizando API é possível realizar a transferência da propriedade de alguns dados entre pessoas.

Serão transferidos

• A propriedade de todas as instâncias de solicitação em andamento onde a pessoa original é o solicitante

• A propriedade de todas as tarefas pendentes onde a pessoa original é o ator responsável

• A propriedade de todas as tarefas pendentes onde a pessoa original é o ator responsável

• Os valores de campos de formulário utilizados para a alocação de tarefas futuras em solicitações em andamento

• As propriedade de todos os objetos administrativos / de gestão

Não serão transferidos

• As informações referentes ao solicitante de de instâncias de solicitações já concluídas

• As informações referentes a execução de atividades já finalizadas

• As informações referentes a mensagens e anexos incluídos em instâncias de solicitações

• Os logs de auditoria

Como preparar uma requisição para transferir a propriedade de dados entre pessoas?

Para transferir os dados basta seguir os passos abaixo:

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

2. Obter o userid e newuserid: O parâmetro userid é o códigoidentificador do usuário de quem se deseja copiar os dados e newuserid o código do usuário de destino. Ambos podem ser obtidos ao explorar a página Acesso > Pessoas no Zeev ou através de consultas de API como explicado em Listar pessoas;

3. Enviar requisição: Envie requisição para o endpoint Transferir propriedade de dados entre pessoas. Lembre-se de substituir seu_endereco.do.zeev pelo endereço que você utiliza para acessar o Zeev;

Transferir a propriedade de dados de uma pessoa para outra (Auth)

post

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 identificador da pessoa de origem

newUserIdinteger · int32Obrigatório

Código identificador da pessoa de destino

Respostas

200

Sucesso.

successbooleanOpcional

Indica se houve sucesso na operação

frominteger · int32Opcional

Código da pessoa de origem

tointeger · int32Opcional

Código da pessoa de destino

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/users/{userid}/transfer/{newuserid}

POST /api/2/users/{userid}/transfer/{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 transferir a propriedade de dados

Node.js

let transferUserId = 573;
let transferNewUserId = 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: "POST",
  headers: myHeaders
};

try {
  const response = await fetch(`https://seu_endereco.do.zeev/api/2/users/${transferUserId}/transfer/${transferNewUserId}`, 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