# Coleções

> Workspaces contêm coleções; coleções contêm pastas e requisições. Esta página cobre a barra lateral — criar, mover, duplicar — e como o Mariner mantém vários projetos separados.

## Workspaces

Um workspace é a caixa de fora: coleções próprias, ambientes próprios, auth padrão própria e seu próprio pote de cookies, então estar logado em um projeto nunca vaza para outro. O Mariner começa com um chamado **Personal**.

- Troque com <kbd>⌘⇧]</kbd> e <kbd>⌘⇧[</kbd>, pelo seletor no topo da barra lateral, ou com <kbd>⌘K</kbd> → *Switch Workspace › nome*.
- O seletor também oferece **New Workspace…**, **Rename…** e **Delete…**.
- O Mariner lembra qual workspace e qual ambiente estavam ativos e os restaura no próximo início.

## A árvore

Uma coleção contém pastas e requisições, aninhadas quanto você quiser. Os itens novos recebem um nome no seu idioma — *Nova coleção*, *Nova pasta*, *Nova requisição* — e abrem em modo renomear.

- **Coleção** (botão direito): Add Request, Add Folder, Import from cURL…, Run Collection…, Edit Auth…, Export as Mariner…, Export as Postman…, Rename, Duplicate, Delete.
- **Pasta**: Add Request, Add Folder, Import from cURL…, Rename, Duplicate, Move to…, Run Folder…, Edit Auth…, Delete.
- **Requisição**: Open in new tab, Rename, Duplicate, Move to…, Run request, Generate Code… (<kbd>⌘⇧C</kbd>), Copy as cURL (<kbd>⌘⌥C</kbd>), Delete.

As duplicatas se chamam *X copy* e depois *X copy 2*. Duplo clique em qualquer nome para renomear; <kbd>↩</kbd> confirma, <kbd>⎋</kbd> cancela. Apagar uma coleção ou pasta com conteúdo pede confirmação.

## Ordem e busca

O cabeçalho acima da árvore tem um controle de ordem (`↑↓`) à esquerda do **+**. Ele fica sempre visível, e assume a cor de destaque assim que a lista sai da ordem de repouso — então o próprio ícone responde "por que elas estão nesta ordem?".

- **Name** — a ordem do Finder: ignora maiúsculas e acentos, e compara os dígitos como números, então `api-v9` vem antes de `api-v10`.
- **Recently used** — o executado mais recentemente primeiro. Uma coleção cuja última execução já saiu da janela do histórico conta como nunca usada, e essas vão para o fim em ordem alfabética — também ao inverter, porque "mais antigo primeiro" não quer dizer "primeiro aquilo de que não sei nada".
- **Number of requests** — contando a subárvore inteira, não só a raiz.
- **Manual** — a ordem em que você as deixou, e o estado de repouso. É também a que precisa estar ativa enquanto você arrasta linhas: em qualquer outro critério, a linha que você solta volta na hora para o lugar.

Cada critério pode ser invertido — *A→Z / Z→A*, *Newest first / Oldest first*, *Most requests first / Fewest requests first* — e a escolha é **salva por workspace**, então mudar de projeto nunca herda a ordem do anterior. Enquanto houver algo diferente de Manual, o rodapé da barra lateral nomeia a ordem ao lado da contagem de coleções, e serve como o mesmo menu.

O campo de busca acima da árvore alcança **coleções, pastas e requisições** — uma requisição também responde pela URL e pelo método. Os contêineres vêm listados primeiro: digitar o nome de uma coleção deve levar você até ela, e não a tudo que está dentro.

## Arrastar e soltar

Todas as linhas podem ser arrastadas. Cada linha tem três zonas de destino: a borda de cima insere **antes**, a de baixo insere **depois**, e o centro solta **dentro** de uma pasta (ou depois de uma requisição). Soltar no cabeçalho de uma coleção move o item para a raiz dela. **Move to…** faz o mesmo por uma folha quando o destino está longe.

## Auth e variáveis no nível da coleção

Uma coleção ou pasta pode ter a própria autenticação, herdada por tudo que está abaixo, e uma requisição pode sobrescrevê-la. A cadeia completa está em [Autenticação](/pt-br/docs/auth). Os ambientes são por workspace, não por coleção — veja [Configurar ambientes](/pt-br/docs/environments).

## Executar, exportar, importar

- **Run Collection…** (<kbd>⌘R</kbd>) ou **Run Folder…** executa a subárvore em ordem; veja [Runner](/pt-br/docs/runner).
- **Export as Mariner…** (<kbd>⌘⇧X</kbd>) escreve um pacote `.mariner` que você pode commitar ou mandar para um colega; **Export as Postman…** escreve uma coleção v2.1. Os segredos são removidos dos dois. Os formatos estão em [Formato de arquivos](/pt-br/docs/file-format).
- Importar de cURL, Postman, OpenAPI ou de outra exportação do Mariner está em [Importar de outros clientes](/pt-br/docs/import).

---
Source: https://marinerhttp.dev/pt-br/docs/collections · Mariner docs