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:

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

  2. 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;

  3. 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);

  4. 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;

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

  6. 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
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

get
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-08-06T21:34:58.579Z",
    "expirationDateTime": "2025-08-06T21:34:58.579Z",
    "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-08-06T21:34:58.579Z",
        "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);
};

Como listar tarefas pendentes com uma pessoa específica usando API e o login do usuário?

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

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

  2. 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;

  3. 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);

  4. 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
Autorizações
Parâmetros de rota
usernamestringObrigatório

Indicação do username 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 atribuições que podem ser concluidas via mobile

Respostas
200

Sucesso

get
GET /api/2/assignments/user/{username} 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-08-06T21:34:58.579Z",
    "expirationDateTime": "2025-08-06T21:34:58.579Z",
    "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-08-06T21:34:58.579Z",
        "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 requisição para obter tarefas pendentes utilizando o username

/* parametros da requisição inicio */
let userName="Pedro";
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/user/${userName}?pageNumber=${pageNumber}&recordsPerPage=${recordsPerPage}&flowId=${flowId}&serviceId=${serviceId}`, requestOptions);
  const result = await response.json();
  console.log(result)
} catch (error) {
  console.error(error);
};

Atualizado