Consultar grupo

Como obter os dados de um grupo de manutenção via API pelo código identificador?

Para obter os dados de um grupo de manutenção via API pelo código identificador, siga estes passos:

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

  2. Obtenha o groupid: Este é o código identificador do grupo de manutenção. É possível encontra-lo na página Avançado > Grupos de permissões ou através de requisições de API como em Consultar grupo;

  3. Enviar requisição: Utilize o endpoint Consultar grupo para obter o grupo desejado;

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

Obter grupo de manutenção pelo código identificador (Auth)

get
Autorizações
Parâmetros de rota
groupIdinteger · int32Obrigatório

Identificador do grupo

Respostas
200

Sucesso

get
GET /api/2/groups/{groupid} HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*
{
  "id": 1,
  "code": "text",
  "name": "text"
}

Exemplo de requisição para obter os grupos de manutenção

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: "GET",
  headers: myHeaders
};

try {
myHeaders.append("Content-Type", "application/json");
  const response = await fetch(`https://seu_endereco.do.zeev/api/2/groups/${groupId}`, requestOptions);
  const result = await response.text();
  console.log(result)
} catch (error) {
  console.error(error);
};

Como obter os dados de um grupo de manutenção via API pelo código original / integração?

Para obter os dados de um grupo de manutenção via API pelo código identificador, siga estes passos:

  1. Autenticação: Primeiro obtenha um token de autenticação;

  2. Obtenha o groupcode: Este é o código identificador do grupo de manutenção. É possível encontra-lo na página Avançado > Grupos de permissões ao editar um grupo, ou através de requisições de API como em Consultar grupo

  3. Enviar requisição: Utilize o endpoint Consultar grupo para obter o grupo desejado;

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

Obter grupo de manutenção pelo código original / integração (Auth)

get
Autorizações
Parâmetros de rota
groupCodestringObrigatório

Código original / integração do grupo

Respostas
200

Sucesso

get
GET /api/2/groups/code/{groupcode} HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*
{
  "id": 1,
  "code": "text",
  "name": "text"
}

Exemplo de requisição para obter os grupos de manutenção

let groupCode = "grP0Adm"

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,
  redirect: "follow"
};

try {
  const response = await fetch(`https://seu_endereco.do.zeev/api/2/groups/code/${groupCode}`, requestOptions);
  const result = await response.text();
  console.log(result)
} catch (error) {
  console.error(error);
};

Atualizado