# 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: 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/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>
```

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.