Listar pessoas do time

Como listar pessoas associadas ao time utilizando API?

Para listar as pessoas de um time 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 teamcode: O teamcode é o código original/integração encontrado na página Acessos > Times do Zeev ou no resultado de requisições de API como explicado em Listar times
Envie a requisição: Utilize o endpoint Listar pessoas do time (troque seu_endereco.do.zeev pelo endereço que você utiliza para acessar o Zeev);
oData: opcionalmente, utilize regras oData para manipular o resultado da API. Essa API aceita $filter, $select, $orderby e $top.

Listar as pessoas associadas a esse time (Auth)

get

Autorizações

AuthorizationstringObrigatório

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

Parâmetros de rota

teamCodestringObrigatório

Código original / integração do time

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/teams/code/{teamcode}/users

GET /api/2/teams/code/{teamcode}/users HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "id": 1,
    "name": "text",
    "username": "text",
    "email": "text",
    "isActive": true,
    "licenseType": "text",
    "position": {
      "id": 1,
      "name": "text",
      "code": "text"
    },
    "team": {
      "id": 1,
      "name": "text",
      "code": "text"
    }
  }
]

Exemplo de requisição para obter os usuários de um time

let teamCode = "t3AmC0d3";

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/teams/code/${teamCode}/users`, requestOptions);
  const result = await response.json();
  console.log(result)
} catch (error) {
  console.error(error);
};

Como obter os usuários de um time e função específicos utilizando API?

Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;
Obtenha o teamcode: O teamcode é o código original/integração do time encontrado na página Acessos > Times ao editar o time, ou no resultado de requisições de API como explicado em Listar times
Obtenha o positioncode: Este é o código original/integração do da função, encontrado na pagina Acessos > Funções ao editar uma função, ou através do resultado de requisições de API como explicado em Listar funções
Envie a requisição: Utilize o endpoint Listar pessoas do time (troque seu_endereco.do.zeev pelo endereço que você utiliza para acessar o Zeev);
oData: opcionalmente, utilize regras oData para manipular o resultado da API. Essa API aceita $filter, $select, $orderby e $top.

Listar as pessoas associadas a esse time com a posição definida (Auth)

get

Autorizações

AuthorizationstringObrigatório

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

Parâmetros de rota

teamCodestringObrigatório

Código original / integração do time

positionCodestringObrigatório

Código original / integração da posição

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/teams/code/{teamcode}/{positioncode}/users

GET /api/2/teams/code/{teamcode}/{positioncode}/users HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "id": 1,
    "name": "text",
    "username": "text",
    "email": "text",
    "isActive": true,
    "licenseType": "text",
    "position": {
      "id": 1,
      "name": "text",
      "code": "text"
    },
    "team": {
      "id": 1,
      "name": "text",
      "code": "text"
    }
  }
]

Exemplo de requisição para obter os usuários de um time e função

let teamCode = "t3amC0de";
let positionCode = "p0S1tionCod3";

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/teams/code/${teamCode}/${positionCode}/users`, requestOptions);
  const result = await response.json();
  console.log(result)
} catch (error) {
  console.error(error);
};

Links relacionados:

AnteriorConsultar um time PróximoListar funções do time

Atualizado há 1 ano