Paper Visão geral da API
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.
Base: https://wire.ia.br/api/v1
Formato: JSON (UTF-8). Arquivos: corpo binário.
Autenticação: Authorization: Bearer paper_…O caminho mais curto
Ligue o modo desenvolvedor em Configurações → Desenvolvedor e aceite os termos da API. Veja Modo desenvolvedor.
Crie um token. Escolha o tipo (seguro para IA, normal para automações), os cofres e o que ele pode fazer. Veja Tokens.
Faça o primeiro pedido:
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.
O que dá para fazer
| Área | Endpoints | Página |
|---|---|---|
| Conta | GET /me | Autenticação |
| Cofres e páginas | GET /vaults, GET/POST /vaults/{cofre}/pages, GET/PATCH/DELETE /vaults/{cofre}/pages/{id} | Cofres e páginas |
| Busca | GET /vaults/{cofre}/search?q= | Busca |
| Arquivos | POST /vaults/{cofre}/files?name= | Anexos |
| Agenda | GET/POST /calendar/events, DELETE /calendar/events/{id} | Agenda |
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.
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
O mapa completo da documentação, com regras e endpoints, está em /documentation/agents/raw.json. Antes de agir, leia Agentes de IA.