# 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](https://kb.zeev.it/apis/como-gerar-tokens-para-autenticar-nas-apis) 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](/zeev/apis/all/access/people/list.md);
3. **Enviar a Requisição**: Utilize o endpoint [#api-2-assignments-user-userid](#api-2-assignments-user-userid "mention") 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](/zeev/apis/como-utilizar-as-apis-do-zeev/como-navegar-entre-paginas-de-retornos-de-apis.md);
5. ***Rate limit:*** Se for paginar os resultados, [respeite os limites máximos de solicitações](/zeev/apis/como-utilizar-as-apis-do-zeev/como-controlar-o-volume-maximo-de-requisicoes-a-apis.md);
6. **oData**: opcionalmente, utilize [regras oData](/zeev/apis/como-utilizar-as-apis-do-zeev/como-realizar-filtros-e-manipulacoes-adicionais-nas-apis-com-odata.md) para manipular o resultado da API. Essa API aceita `$select`

{% openapi src="/files/DYIxvabeLXa2mL6uE2si" path="/api/2/assignments/user/{userid}" method="get" %}
[ZeevApi's\_new.json](https://3371003943-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MD66pBdRalAQgnhNstG%2Fuploads%2Ff5huLIsAqm88oSjkTavv%2FZeevApi's_new.json?alt=media\&token=aae47f9f-90ca-48d0-b250-fc38fe74e6c0)
{% endopenapi %}

Exemplo de requisição para obter tarefas pendentes utilizando código do usuário

{% tabs %}
{% tab title="Node.js" %}

```javascript
/*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);
};
```

{% endtab %}
{% endtabs %}

***

## 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](https://kb.zeev.it/apis/como-gerar-tokens-para-autenticar-nas-apis) 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](/zeev/apis/all/access/people/list.md);
3. **Enviar a Requisição**: Utilize o endpoint [#api-2-assignments-user-username](#api-2-assignments-user-username "mention") 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](/zeev/apis/como-utilizar-as-apis-do-zeev/como-navegar-entre-paginas-de-retornos-de-apis.md);

{% openapi src="/files/DYIxvabeLXa2mL6uE2si" path="/api/2/assignments/user/{username}" method="get" %}
[ZeevApi's\_new.json](https://3371003943-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MD66pBdRalAQgnhNstG%2Fuploads%2Ff5huLIsAqm88oSjkTavv%2FZeevApi's_new.json?alt=media\&token=aae47f9f-90ca-48d0-b250-fc38fe74e6c0)
{% endopenapi %}

Exemplo requisição para obter tarefas pendentes utilizando o username

{% tabs %}
{% tab title="Node.js" %}

```javascript
/* 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);
};
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.stoque.com.br/zeev/apis/all/assignments/list-users.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.