# Visão geral da API

Fonte: https://wire.ia.br/documentation/api/visao-geral

> O que a API pessoal faz, para quem ela serve e o caminho mais curto até o primeiro pedido.



A API pessoal deixa um programa ou um agente de IA ler e escrever no caderno de **uma pessoa**, com um token que essa pessoa criou e pode revogar a qualquer momento. Não existe API para ler dados de outras contas, nem acesso de terceiros sem um token.

```txt
Base: https://wire.ia.br/api/v1
Formato: JSON (UTF-8). Arquivos: corpo binário.
Autenticação: Authorization: Bearer paper_…
```

## O caminho mais curto [#o-caminho-mais-curto]

<Steps>
  <Step>
    **Ligue o modo desenvolvedor** em Configurações → Desenvolvedor e aceite os [termos da API](/termos/termos-da-api). Veja [Modo desenvolvedor](/api/modo-desenvolvedor).
  </Step>

  <Step>
    **Crie um token.** Escolha o tipo (seguro para IA, normal para automações), os cofres e o que ele pode fazer. Veja [Tokens](/api/tokens).
  </Step>

  <Step>
    **Faça o primeiro pedido:**

    ```bash
    curl https://wire.ia.br/api/v1/me \
      -H "Authorization: Bearer $PAPER_TOKEN" \
      -H "X-Paper-Account: $PAPER_CONTA"
    ```

    A resposta mostra a conta, as permissões do token e os limites.
  </Step>
</Steps>

## O que dá para fazer [#o-que-dá-para-fazer]

| Área             | Endpoints                                                                                      | Página                                    |
| ---------------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------- |
| Conta            | `GET /me`                                                                                      | [Autenticação](/api/autenticacao)         |
| Cofres e páginas | `GET /vaults`, `GET/POST /vaults/{cofre}/pages`, `GET/PATCH/DELETE /vaults/{cofre}/pages/{id}` | [Cofres e páginas](/api/cofres-e-paginas) |
| Busca            | `GET /vaults/{cofre}/search?q=`                                                                | [Busca](/api/busca)                       |
| Arquivos         | `POST /vaults/{cofre}/files?name=`                                                             | [Anexos](/api/anexos)                     |
| Agenda           | `GET/POST /calendar/events`, `DELETE /calendar/events/{id}`                                    | [Agenda](/api/agenda)                     |

## Onde os dados moram [#onde-os-dados-moram]

As notas pessoais não ficam no servidor do Paper. Elas ficam no aparelho da pessoa e no Google Drive dela. Por isso:

* **Token normal**: o servidor lê e escreve no Google Drive da pessoa no momento do pedido, usando a conexão que ela liberou para a API. Só cofres sincronizados com o Drive aparecem.
* **Token seguro**: o servidor guarda uma cópia isolada de um cofre, criada quando a pessoa fez o token. A IA trabalha nessa cópia, e a pessoa decide o que levar para o cofre de verdade. Veja [Cópias para IA](/api/copias-para-ia).

## O que nenhum token faz [#o-que-nenhum-token-faz]

* Abrir páginas protegidas por senha (`423`).
* Ler grupos, que são criptografados de ponta a ponta.
* Mexer na conta, nas sessões, nas amizades ou nas configurações.

## Para agentes de IA [#para-agentes-de-ia]

O mapa completo da documentação, com regras e endpoints, está em [`/documentation/agents/raw.json`](https://wire.ia.br/documentation/agents/raw.json). Antes de agir, leia [Agentes de IA](/api/agentes-de-ia).