Listar minhas tarefas pendentes

Como listar as minhas tarefas pendentes com API?

Para consultar e obter uma lista das tarefas pendentes com o usuário autenticado na API siga os passos abaixo:

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 Listar minhas tarefas pendentes para enviar a requisição conforme modelo e exemplo (Troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev):

3. Paginar: Observe que a consulta à essa API retorna um número limitado de registros; para obter todos os dados, será necessário implementar um algoritmo de paginação;

4. Rate limit: Se for paginar os resultados, respeite os limites máximos de solicitações;

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

Listar as atribuições de atividades pendentes da pessoa relacionada ao token de autenticação (Auth)

get

Autorizações

Bearer

AuthorizationstringObrigatório

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

Parâmetros de consulta

pageNumberinteger · int32Opcional

Indicação do número da página para paginação de registros

recordsPerPageinteger · int32Opcional

Indicação do número de registros a serem retornados

flowIdinteger · int32Opcional

Código identificador do processo a ser filtrado

serviceIdinteger · int32Opcional

Código identificador dao serviço a ser filtrado

appCodestringOpcional

Código identificador do aplicativo de processos a ser filtrado

mobileEnabledOnlybooleanOpcional

Indicativo se devem ser listadas somente as atividades que podem ser concluidas via mobile

Respostas

200

Sucesso

application/jsontext/jsontext/xml

idinteger · int64Opcional

Identificador da atribuição de atividade

taskLinkstringOpcional

Link de execução da atividade

taskNamestringOpcional

Título da atividade

requestNamestringOpcional

Nome do requisitante da solicitação

latebooleanOpcional

Indica se a atividade está com SLA vencido

activebooleanOpcional

Indica se a atividade está disponível para execução

startDateTimestring · date-timeOpcional

Data em que a atividade foi criada

expirationDateTimestring · date-timeOpcional

Data de vencimento do SLA da atividade

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

get

/api/2/assignments

HTTPcURLJavaScriptPython

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

[
  {
    "id": 1,
    "taskLink": "text",
    "taskName": "text",
    "requestName": "text",
    "late": true,
    "active": true,
    "startDateTime": "2026-03-21T06:51:45.912Z",
    "expirationDateTime": "2026-03-21T06:51:45.912Z",
    "assignee": {
      "id": 1,
      "name": "text",
      "email": "text",
      "username": "text"
    },
    "flow": {
      "id": 1,
      "version": 1,
      "uid": "00000000-0000-0000-0000-000000000000",
      "name": "text"
    },
    "instance": {
      "id": 1,
      "uid": "00000000-0000-0000-0000-000000000000",
      "masterInstanceId": 1,
      "starterInstanceId": 1,
      "instanceTask": {
        "id": 1,
        "startDateTime": "2026-03-21T06:51:45.912Z",
        "task": {
          "id": 1,
          "name": "text",
          "type": "text",
          "description": "text",
          "element": {
            "id": 1,
            "alias": "text"
          }
        }
      }
    },
    "service": {
      "id": 1,
      "name": "text",
      "uid": "00000000-0000-0000-0000-000000000000"
    }
  }
]

Exemplo de requisição para obter a lista de tarefas pendentes com a pessoa do token de autenticação

Node.js

/* parametros da requisição inicio */
let pageNumber=1;
let recordsPerPage=10;
let flowId=100;
let serviceId=101;
/* parametros da requisição fim*/

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/assignments?pageNumber=${pageNumber}&recordsPerPage=${recordsPerPage}flowId=${flowId}&serviceId=${serviceId}`, 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 receber e filtrar tarefas