> For the complete documentation index, see [llms.txt](https://kb.stoque.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.stoque.com.br/zeev/apis/como-utilizar-as-apis-do-zeev/como-testar-o-funcionamento-de-apis/como-configurar-o-postman-para-testar-as-apis-do-zeev.md).

# Como configurar o Postman para testar as API's do Zeev?

## Como importar a coleção do Zeev no Postman?

Para realizar testes das API's zeev com o Postman, é possível importar os dados de OpenAPI exportados automaticamente pelo zeev no seu ambiente.\
\
Existem algumas práticas que vão ajuda-lo a obter a documentação do Zeev no seu Postman de forma mais organizada oferecendo um melhor proveito.\
Para isso siga os passos abaixo:

1. **Obtenha o Postman:** Instale o [**Postman** ](https://www.postman.com/)ou obtenha uma conta gratuita para uso online. Neste tutorial vamos utilizar a versão Desktop Instalada em um computador windows;
2. **Obtenha uma conta no Postman:** No primeiro acesso será solicitado a criação de uma conta gratuita no Postman. Você deve cria-la ou apenas autenticar-se se já for um usuário cadastrado. <br>

   <figure><img src="/files/0SjtY6jRiKzT2hTsbNqd" alt="" width="459"><figcaption></figcaption></figure>
3. **Importe a coleção do Zeev:** Clique em import<br>

   <figure><img src="/files/xagx2QjQMkmHPuXEHpNv" alt="" width="563"><figcaption></figcaption></figure>
4. **Informar a origem da documentação:** Na nova janela que surgir, informe o endereço <https://seu\\_dominio.do.zeev/api/2/docs>, informe no lugar de seu\_dominio.do.zeev o endereço que você utilizada para acessar o Zeev. Ou se preferir, faça download do [#modelo-para-download-do-zeev-openapi](#modelo-para-download-do-zeev-openapi "mention") e importe no seu ambiente:
5. **Configure a importação:** Após informar o endereço do OpenAPI.json ou importar o modelo disponibilizado, cliente em view import settings na janela que surgir, e altere o parâmetro "**folder organization**" de **paths** para **tags**, depois volte e clique em impor&#x74;**:**\ <br>

   <figure><img src="/files/GTZNRdw7d40PWLRKU2BB" alt=""><figcaption></figcaption></figure>

   <figure><img src="/files/tuOJkryTQBXfrEYLKj2g" alt=""><figcaption></figcaption></figure>
6. **Configure o seu endereço:** Se você importou o modelo desta página, clique nos três pontos a frente da pasta criada para a coleção, depois clique em varáveis e informe o seu endereço do Zeev:<br>

   <figure><img src="/files/pfFgva0CXcci1R9jnXXV" alt=""><figcaption></figcaption></figure>
7. **Configure a autenticação em nível global:** Ainda na pasta da coleção, clique na guia Authorization, troque Auth Type para Bearer Token, e informe um [token ](/zeev/apis/como-utilizar-as-apis-do-zeev/como-gerar-tokens-para-autenticar-nas-apis.md)válido de usuário do Zeev e clique em salvar.\
   Com esta configuração, os endpoints "herdam" a autorização e você não vai precisar inclui-las manualmente em todas as chamadas.\ <br>

   <figure><img src="/files/rWDmGRzFYhVCV3l5KNio" alt=""><figcaption></figcaption></figure>

## Modelo para download do Zeev OpenAPI

{% file src="/files/DYIxvabeLXa2mL6uE2si" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://kb.stoque.com.br/zeev/apis/como-utilizar-as-apis-do-zeev/como-testar-o-funcionamento-de-apis/como-configurar-o-postman-para-testar-as-apis-do-zeev.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.