Listar aplicativos que posso editar

Como listar aplicativos que a pessoa autenticada na API pode editar?

Para listar os aplicativos que a pessoa autenticada à API possui permissão para editar, siga os passos abaixo:

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

2. Prepare filtros: Os parâmetros desta requisição não são obrigatórios, você pode utilizar um ou uma combinação deles para filtrar a consulta. Considere aplicar os filtros sempre que possível para obter uma melhor performance.

3. Enviar a Requisição: Utilize o endpoint Listar aplicativos que posso editar para enviar a requisição conforme modelo e exemplo (Troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev);

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

Lista de aplicativos que posso editar (Auth)

get

Autorizações

AuthorizationstringObrigatório

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

Parâmetros de consulta

flowIdinteger · int32Opcional

Código identificador do aplicativo

flowNamestringOpcional

Nome do aplicativo

flowVersioninteger · int32Opcional

Versão do aplicativo

deploybooleanOpcional

True para retornar aplicativos publicados ou False para não publicados

categoryIdinteger · int32Opcional

Código identificador da categoria do aplicativo

Respostas

200

Sucesso

flowIdinteger · int32Opcional

Código identificador do aplicativo

flowUidstringOpcional

GUID identificador do aplicativo

flowNamestringOpcional

Nome do aplicativo

flowDescriptionstringOpcional

Descrição do aplicativo

flowVersioninteger · int32Opcional

Versão do aplicativo

teamNamestringOpcional

Nome do time configurado como responsável pelo aplicativo

deploybooleanOpcional

Indica se o aplicativo está publicado

categoryIdinteger · int32Opcional

ID da categoria de aplicativos

categoryNamestringOpcional

Nome da categoria do aplicativo

parentIdinteger · int32Opcional

Código do aplicativo a partir do qual foi gerado esta versão

lastDeploystring · date-timeOpcional

Data de publicação

executionModestringOpcional

Modo de execução

activebooleanOpcional

Indica se o aplicativo está ativo

userOwnerstringOpcional

Código do usuário que criou o aplicativo

inboxstringOpcional

Texto apresentado como prévia no monitoramento de solicitações

tasksstringSomente leituraOpcional

Endpoint para obter as tarefas do aplicativo

formstringSomente leituraOpcional

Endpoint para obter o formulário do aplicativo

usersstringSomente leituraOpcional

Endpoint para obter a lista de pessoas que atuam neste aplicativo

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/flows/edit

GET /api/2/flows/edit HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Accept: */*

{
  "flowId": 1,
  "flowUid": "text",
  "flowName": "text",
  "flowDescription": "text",
  "flowVersion": 1,
  "teamName": "text",
  "deploy": true,
  "categoryId": 1,
  "categoryName": "text",
  "parentId": 1,
  "lastDeploy": "2026-01-01T00:00:00.000Z",
  "executionMode": "text",
  "active": true,
  "userOwner": "text",
  "inbox": "text",
  "tasks": "text",
  "form": "text",
  "users": "text"
}

Exemplo de requisição para listar aplicativos que a pessoa autenticada pode editar

Node.js

//Parâmetros
let flowId = 100;
let flowNamee = 'Compras';
let flowVersion = 1;
let deploy = true;
let categoryId = 1;
//Headers
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/edit?flowId=${flowId}&flowName=${flowName}&flowVersion=${flowVersion}&deploy=${deploy}&categoryId=${categoryId}`, 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

• O que são aplicativos