Contar todas as solicitações do sistema

Como obter a quantidade de instâncias de solicitações do Zeev que uma pessoa tem permissão de consultar de acordo com filtros utilizando as API's do Zeev?

Para obter a quantidade de instâncias de solicitação que uma pessoa pode consultar, você deve adotar os seguintes passos:

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

2. Enviar a Requisição: Utilize o endpoint abaixo para enviar a requisição conforme modelo e exemplo (Troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev):

Contar as instâncias de solicitações que a pessoa relacionada ao token possui permissão de consultar de acordo com filtros (Auth)

post

Corpo

application/json

appCodestringOpcional

Código criptografado identificador do aplicativo de processos

startDateIntervalBeginstring · date-timeOpcional

Data de início do intervalo de solicitação

startDateIntervalEndstring · date-timeOpcional

Data de fim do intervalo de solicitação

endDateIntervalBeginstring · date-timeOpcional

Data de início do intervalo de fim da solicitação

endDateIntervalEndstring · date-timeOpcional

Data de fim do intervalo de fim da solicitação

lastTaskEndDateIntervalBeginstring · date-timeOpcional

Data de início do intervalo de última tarefa finalizada

lastTaskEndDateIntervalEndstring · date-timeOpcional

Data de fim do intervalo de última tarefa finalizada

simulationbooleanOpcional

Indicador se devem ser pesquisadas simulações

activebooleanOpcional

Indicador se devem ser pesquisas somente instâncias em andamento

flowsIdinteger · int32[]Opcional

Números identificadores dos processos

servicesIdinteger · int32[]Opcional

Números identificadores dos serviços

mobileEnabledOnlybooleanOpcional

Indicador se devem ser listados somente processos habilitados para mobile

requesterUsernamestringOpcional

Username da pessoa solicitante

useCachebooleanOpcional

Define se será utilizado cache

Respostas

200

Sucesso

application/jsontext/jsontext/xml

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

post

/api/2/instances/report/count

HTTPcURLJavaScriptPython

POST /api/2/instances/report/count HTTP/1.1
Host: seu_endereco.do.zeev
Content-Type: application/json
Accept: */*
Content-Length: 535

{
  "appCode": "XkasdjlmexlW2902_",
  "startDateIntervalBegin": "2020-01-31T00:00:00",
  "startDateIntervalEnd": "2020-12-31T23:59:59",
  "endDateIntervalBegin": "2020-01-31T00:00:00",
  "endDateIntervalEnd": "2020-01-31T00:00:00",
  "lastTaskEndDateIntervalBegin": "2020-01-31T00:00:00",
  "lastTaskEndDateIntervalEnd": "2020-01-31T00:00:00",
  "simulation": false,
  "active": true,
  "flowsId": [
    100,
    201
  ],
  "servicesId": [
    200,
    201
  ],
  "mobileEnabledOnly": false,
  "requesterUsername": "steve.jobs",
  "useCache": true,
  "formFieldsFilter": [
    {
      "name": "campo",
      "operator": "=",
      "value": "valor"
    }
  ]
}

{
  "count": 1
}

Exemplo de solicitação:

Node.js

const myHeaders = new Headers();

myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer TOKEN_DO_USUARIO");

const raw = JSON.stringify({
  "appCode": "XkasdjlmexlW2902_",
  "startDateIntervalBegin": "2020-01-31T00:00:00",
  "startDateIntervalEnd": "2020-12-31T23:59:59",
  "endDateIntervalBegin": "2020-01-31T00:00:00",
  "endDateIntervalEnd": "2020-01-31T00:00:00",
  "lastTaskEndDateIntervalBegin": "2020-01-31T00:00:00",
  "lastTaskEndDateIntervalEnd": "2020-01-31T00:00:00",
  "simulation": false,
  "active": true,
  "flowsId": [
    100,
    201
  ],
  "servicesId": [
    200,
    201
  ],
  "mobileEnabledOnly": false,
  "requesterUsername": "steve.jobs",
  "useCache": true,
  "formFieldsFilter": [
    {
      "name": "campo",
      "operator": "=",
      "value": "valor"
    }
  ]
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw
};

try {
  const response = await fetch("https://seu_endereco.do.zeev/api/2/instances/report/count", requestOptions);
  const result = await response.text();
  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 filtrar e monitorar solicitações