# Consultar dados de uma pessoa

{% hint style="info" %}
Assista como é realizada a conexão dessa API [**no vídeo abaixo**](#video-de-exemplo-de-uso).
{% endhint %}

## Como consultar os dados de uma pessoa utilizando API e o código identificador da pessoa (userId)?

Você pode consultar os dados de cadastro de uma pessoa específica no Zeev utilizando API e o código identificador da pessoa (userId). Siga os passos abaixo:

1. **Obtenha o UserId:** Obtenha o código identificador da pessoa. Ele pode ser encontrado na página de cadastro de usuários em Acesso > Pessoas, ou pode ser obtido como retorno de alguma consulta de API identificado como por exemplo em [consultar de solicitações](/zeev/apis/all/instances/report.md#como-consultar-solicitacoes-utilizando-as-apis-do-zeev) (na propriedade requester > id ) ou em muitos outros.
2. **Autenticação**: Obtenha um [token de autenticação](/zeev/apis/como-utilizar-as-apis-do-zeev/como-gerar-tokens-para-autenticar-nas-apis.md) com permissão de realizar essa operação.
3. **Enviar a Requisição**: Utilize o endpoint [#api-2-users-userid](#api-2-users-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. **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/users/{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 como obter os dados de uma pessoa utilizando API e userId

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

```javascript
let userId = 379;

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/users/${userId}`, requestOptions);
  const result = await response.json();
  console.log(result)
} catch (error) {
  console.error(error);
};

/*
Se desejar modifique a URL para incluir consulta oData
e retornar apenas as propridades de que precisa no resultado
veja o exemplo abaixo
*/

let urlAddress = `https://seu_endereco.do.zeev/api/2/users/${userId}`;
urlAddress = `${urlAddress}?$select=name,email`;

// Ao utilizar o endereço acima na requisição, o corpo de resposta trará apenas o nome e o e-mail do usuário
```

{% endtab %}
{% endtabs %}

***

### Vídeo de exemplo de uso

{% embed url="<https://youtu.be/Vvzga08uF8c>" %}

## Como consultar os dados de uma pessoa utilizando API e o login de usuário da pessoa (username)?

Você pode consultar os dados de cadastro de uma pessoa específica no Zeev utilizando API e o login de usuário da pessoa (username), para isso, siga os passos abaixo:

1. **Obtenha o UserId:** Obtenha o código identificador da pessoa, ele pode ser encontrado na página de cadastro de usuários em Acesso > Pessoas, ou pode ser obtido como retorno de alguma consulta de API identificado como por exemplo em [consultar de solicitações](/zeev/apis/all/instances/report.md#como-consultar-solicitacoes-utilizando-as-apis-do-zeev) (na propriedade requester > name) ou em muitos outros.
2. **Autenticação**: Obtenha um [token de autenticação](/zeev/apis/como-utilizar-as-apis-do-zeev/como-gerar-tokens-para-autenticar-nas-apis.md) com permissão de realizar essa operação.
3. **Enviar a Requisição**: Utilize o endpoint [#api-2-users-username](#api-2-users-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. **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`.

{% hint style="info" %}
Além do uso do endpoint indicado no exemplo abaixo \[Route("{username}")], está disponível uma rota com o seguinte endereço \[Route("username/{username}")].
{% endhint %}

{% openapi src="/files/DYIxvabeLXa2mL6uE2si" path="/api/2/users/{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 %}

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

```javascript
let userName = 'Jhony';

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/users/${userName}`, requestOptions);
  const result = await response.json();
  console.log(result)
} catch (error) {
  console.error(error);
};

/*
Se desejar modifique a URL para incluir consulta oData
e retornar apenas as propridades de que precisa no resultado
veja o exemplo abaixo
*/

let urlAddress = `https://seu_endereco.do.zeev/api/2/users/${userId}`;
urlAddress = `${urlAddress}?$select=name,email`;

// Ao utilizar o endereço acima na requisição, o corpo de resposta trará apenas o nome e o e-mail do usuário
```

{% 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/access/people/consult.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.