Paper Visión general de la API
Qué hace la API personal, para quién es y el camino más corto hasta la primera solicitud.
La API personal deja que un programa o un agente de IA lea y escriba en el cuaderno de una persona, con un token que esa persona creó y puede revocar en cualquier momento. No existe API para leer datos de otras cuentas, ni acceso de terceros sin un token.
Base: https://wire.ia.br/api/v1
Formato: JSON (UTF-8). Archivos: cuerpo binario.
Autenticación: Authorization: Bearer paper_…
Idioma de los errores: Accept-Language: es (o pt-BR, en)Los nombres de los campos de la API están en portugués (conta, titulo, permissoes…), iguales para todos los idiomas. Los mensajes de error siguen Accept-Language.
El camino más corto
Activa el modo desarrollador en Configuración → Desarrollador y acepta los términos de la API. Mira Modo desarrollador.
Crea un token. Elige el tipo (seguro para IA, normal para automatizaciones), las bóvedas y lo que puede hacer. Mira Tokens.
Haz la primera solicitud:
curl https://wire.ia.br/api/v1/me \
-H "Authorization: Bearer $PAPER_TOKEN" \
-H "X-Paper-Account: $PAPER_CUENTA" \
-H "Accept-Language: es"La respuesta muestra la cuenta, los permisos del token y los límites.
Qué se puede hacer
| Área | Endpoints | Página |
|---|---|---|
| Cuenta | GET /me | Autenticación |
| Bóvedas y páginas | GET /vaults, GET/POST /vaults/{boveda}/pages, GET/PATCH/DELETE /vaults/{boveda}/pages/{id} | Bóvedas y páginas |
| Búsqueda | GET /vaults/{boveda}/search?q= | Búsqueda |
| Archivos | POST /vaults/{boveda}/files?name= | Adjuntos |
| Agenda | GET/POST /calendar/events, DELETE /calendar/events/{id} | Agenda |
Dónde viven los datos
Las notas personales no quedan en el servidor de Paper. Quedan en el dispositivo de la persona y en su Google Drive. Por eso:
- Token normal: el servidor lee y escribe en el Google Drive de la persona en el momento de la solicitud, usando la conexión que ella habilitó para la API. Solo aparecen las bóvedas sincronizadas con Drive.
- Token seguro: el servidor guarda una copia aislada de una bóveda, creada cuando la persona hizo el token. La IA trabaja en esa copia, y la persona decide qué llevar a la bóveda real. Mira Copias para IA.
Lo que ningún token hace
- Abrir páginas protegidas con contraseña (
423). - Leer grupos, que están cifrados de extremo a extremo.
- Tocar la cuenta, las sesiones, las amistades o la configuración.
Para agentes de IA
El mapa completo de la documentación, con reglas y endpoints, está en /documentation/agents/raw.json. Antes de actuar, lee Agentes de IA.