# 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: 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://docs.barte.com/collections/como-utilizar/quickstart.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.