> For the complete documentation index, see [llms.txt](https://docs.barte.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.barte.com/guias/inicio/collections.md).

# Collections

Para facilitar seus testes e integrações, disponibilizamos coleções pré-configuradas da API da Barte.\
Você pode importar essas coleções nos principais clientes de API:

* **Postman** ⚡
* **Insomnia** 🌙

Essas coleções já incluem:

* Endpoints organizados por recurso
* Exemplos de requisição e resposta
* Headers obrigatórios (incluindo `X-Token-Api`)
* Estrutura pronta para que você apenas configure seu token e comece a testar

### <i class="fa-bolt">:bolt:</i> Usando no Postman

Você pode **fazer o fork da collection** diretamente no Postman clicando no link abaixo:

<i class="fa-right">:right:</i>  [Fork da Collection no Postman](https://www.postman.com/washington-rodrigues/barte-collection/collection/hf15utp/barte-api?action=share\&creator=45328072)

O fork cria uma cópia sincronizada com nossa collection oficial, permitindo que você receba atualizações sempre que houver alterações.

***

### <i class="fa-floppy-disk">:floppy-disk:</i> Importando via arquivo JSON

Se preferir, você pode **baixar o arquivo `.json`** e importar manualmente:

<a href="https://prdc-n8n-webhook.barte.com/webhook/barte-collection/postman/download" class="button primary" data-icon="down-to-line">Baixar Collection</a>

#### <i class="fa-thumbtack">:thumbtack:</i> Como importar:

* **No Postman** → `Import > File` e selecione o `.json`.
* **No Insomnia** → `Application → Preferences → Data → Import Data → From File` e selecione o mesmo `.json`.

> <i class="fa-check">:check:</i> O mesmo arquivo funciona para os dois clientes.

***

### <i class="fa-screwdriver-wrench">:screwdriver-wrench:</i> Dicas

* Todas as requisições exigem o header **X-Token-Api** (veja a seção Como obter o Token de API).
* As collections já vêm com exemplos de `body`, `headers` e parâmetros prontos. Basta substituir pelos dados da sua conta.
* Se optar pelo fork no Postman, mantenha sua collection sincronizada para receber atualizações automaticamente.


---

# 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://docs.barte.com/guias/inicio/collections.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.