Listar funções do time

Como listar as funções vinculadas a um time utilizando API?

Para listar as funções vinculadas a um time, 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 teamid: O teamid é o código identificador do time, encontrado na página Acessos > Times ou no resultado de requisições de API como explicado em Listar times

3. Envie a requisição: Utilize o endpoint Listar funções do time (troque seu_endereco.do.zeev pelo endereço que você utiliza para acessar o Zeev);

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

Listar as funções relacionadas ao time (Auth)

get

Autorizações

AuthorizationstringObrigatório

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

Parâmetros de rota

teamIdinteger · int32Obrigatório

Identificador do time

Respostas

200

Sucesso

idinteger · int32Opcional

Identificador da função

codestringOpcional

Código original / Integração

namestringOpcional

Nome da função

levelstringOpcional

Relação de níveis hierarquicos

activebooleanOpcional

Indica se a função está ativa

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/{teamid}/positions

GET /api/2/teams/{teamid}/positions HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*

{
  "id": 1,
  "code": "text",
  "name": "text",
  "level": "text",
  "active": true
}

Exemplo de requisição para listar funções de um time

Node.js

let teamId = 851;

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/${teamId}/positions`, requestOptions);
  const result = await response.json();
  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

• Como criar times