# Setup do Postman

#### Configuração de Acesso à API

Para configurar o acesso à AP, siga os passos abaixo:

1. Acesse o menu `Empresa > Dados API`. Esta opção está disponível somente para os administradores da empresa.
2. Insira o nome e o e-mail do integrador responsável pela conexão com a API.

Após a conclusão destes passos, o integrador receberá um e-mail contendo:

* Um link temporário para consulta e edição das credenciais de acesso à API.
* Um ficheiro necessário para a utilização com o Postman.

**Setup Postman**

Após acessar a página de downloads do Postman em <https://www.postman.com/downloads/> e concluir a instalação do software, na página inicial, selecione a opção "**Importar**" para prosseguir.

<figure><img src="/files/7g6chbjr9ldg4Wf4gQVs" alt=""><figcaption></figcaption></figure>

A partir deste ponto, deverá importar o ficheiro descarregado na página de credenciais da API.

Com este ficheiro importado, deverá ter uma nova coleção aberta, com os possíveis pedidos à API disponibilizados.

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

Antes de realizar qualquer pedido, é necesário realizar a autenticação. Para o efeito, deve clicar em Open APIDe seguida, deve clicar em "autenticação".

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

Daqui, deverá ter todos os campos como mostrado na imagem, ir ao final da página e clicar em "Gerar novo token de acesso". Este processo irá abrir uma página no seu browser, que deverá ativar um pop-up. Caso este pop-up não surja, deverá garantir que não tem a opção de 'permitir pop-ups' desativada. Quando o pop-up surjir, deverá clicar na checkbox que surge no popup, antes de confirmar a operação.

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

Para finalizar, voltar ao início da página, e selecionar o token gerado.

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

**Pedidos à API**

A partir deste ponto, todos os passos estão concluidos para a experimentação com a API. De modo a enviar um pedido à API, deve selecionar o pedido que quer enviar, na barra lateral esquerda.

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

Aberto o pedido, pode editar os parâmetros que deseja enviar, e enviar o pedido utilizando o botão "enviar".

A resposta do pedido irá surgir na caixa "Resposta"

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


---

# 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://api-docs.toconline.pt/setup-do-postman.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.