Listar tarefas pendentes de um usuário

Como listar tarefas pendentes de uma pessoa específica usando API e código do usuário?

Para obter a lista de tarefas pendentes com uma pessoa utilizando o código do usuário, siga estes passos:

Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;
Obtenha o userid: Obtenha o código identificador do usuário na página Acesso > Pessoas ou através de consultas de API conforme descrito em Listar pessoas;
Enviar a Requisição: Utilize o endpoint Listar tarefas pendentes de um usuário para enviar a requisição conforme modelo e exemplo (Troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev);
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;
Rate limit: Se for paginar os resultados, respeite os limites máximos de solicitações;
oData: opcionalmente, utilize regras oData para manipular o resultado da API. Essa API aceita $select

Listar as atividades atribuidas a uma pessoa por código (Auth)

get

Autorizações

AuthorizationstringObrigatório

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

Parâmetros de rota

userIdinteger · int32Obrigatório

Indicação do código da pessoa cujas atribuições serão listadas

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

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/assignments/user/{userid}

GET /api/2/assignments/user/{userid} 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": "2025-12-15T14:17:31.966Z",
    "expirationDateTime": "2025-12-15T14:17:31.966Z",
    "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": "2025-12-15T14:17:31.966Z",
        "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 tarefas pendentes utilizando código do usuário

/*Parametros inicio*/
let userId = 789; //Código do usuário
let pageNumber=1;
let recordsPerPage=10;
let flowId=100;
let serviceId=101;
/*Parametros 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/user/${userId}?pageNumber=${pageNumber}&recordsPerPage=${pageNumber}&flowId=${flowId}&serviceId=${serviceId}`, requestOptions);
  const result = await response.json();
  console.log(result)
} catch (error) {
  console.error(error);
};

Para obter a lista de tarefas pendentes com uma pessoa utilizando o login do usuário, siga estes passos:

Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;
Obtenha o username: Este é o login do usuário. Pode ser localizado na página de cadastro de pessoas em Acesso > Pessoas ao editar um registro, ou através de consultas de API conforme descrito em Listar pessoas;
Enviar a Requisição: Utilize o endpoint Listar tarefas pendentes de um usuário para enviar a requisição conforme modelo e exemplo (Troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev);
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;

Listar as atividades atribuidas a uma pessoa por username (Auth)

get