Listar pessoas vinculadas ao aplicativo

Como listar pessoas que compõem o design do aplicativo?

Se você precisar obter a lista de pessoas que compõem um aplicativo, siga os passos abaixo:

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

2. Obtenha o flowId: Obtenha o código identificador do aplicativo, você pode fazer isso explorando o Zeev na página Construir > Aplicativos ou utilizando alguma API como por exemplo esta. Após obter o flowId.

3. Enviar a Requisição: Utilize o endpoint Listar pessoas vinculadas ao aplicativo para enviar a requisição conforme modelo e exemplo (Troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev e {flowId} pelo código identificador do aplicativo);

4. oData: opcionalmente, utilize regras oData para manipular o resultado da API. Essa API aceita $filter, $select, $orderby e $top.

Lista as pessoas que compõem o design do aplicativo (Auth)

get

Autorizações

Bearer

AuthorizationstringObrigatório

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

Parâmetros de rota

flowIdinteger · int32Obrigatório

Código identificador do aplicativo

Respostas

200

Sucesso

application/jsontext/jsontext/xml

flowIdinteger · int32Opcional

Código do aplicativo

userIdinteger · int32Opcional

Id do usuário

usernamestringOpcional

Login do usuário

namestringOpcional

Nome do usuário

emailstringOpcional

Endereço de e-mail do usuário

documentstringOpcional

CPF/CNPJ do usuário

identificationstringOpcional

Matrícula do usuário

teamNamestringOpcional

Time

positionNamestringOpcional

Função

400

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

application/jsontext/jsontext/xml

401

Pessoa não autorizada

application/jsontext/jsontext/xml

403

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

application/jsontext/jsontext/xml

404

O registro não foi encontrado

application/jsontext/jsontext/xml

429

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

application/jsontext/jsontext/xml

500

Ocorreu algum erro interno no servidor

application/jsontext/jsontext/xml

get

/api/2/flows/{flowid}/design/users

HTTPcURLJavaScriptPython

GET /api/2/flows/{flowid}/design/users HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*

{
  "flowId": 1,
  "userId": 1,
  "username": "text",
  "name": "text",
  "email": "text",
  "document": "text",
  "identification": "text",
  "teamName": "text",
  "positionName": "text"
}

Node.js

let flowId = 268;
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/flows/${flowId}/design/users`, requestOptions);
  const result = await response.json();
  console.log(result)
} catch (error) {
  console.error(error);
};