# 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.