# Visión general de la API

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

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

```txt
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 [#el-camino-más-corto]

<Steps>
  <Step>
    **Activa el modo desarrollador** en Configuración → Desarrollador y acepta los [términos de la API](/es/termos/termos-da-api). Mira [Modo desarrollador](/es/api/modo-desenvolvedor).
  </Step>

  <Step>
    **Crea un token.** Elige el tipo (seguro para IA, normal para automatizaciones), las bóvedas y lo que puede hacer. Mira [Tokens](/es/api/tokens).
  </Step>

  <Step>
    **Haz la primera solicitud:**

    ```bash
    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.
  </Step>
</Steps>

## Qué se puede hacer [#qué-se-puede-hacer]

| Área              | Endpoints                                                                                        | Página                                        |
| ----------------- | ------------------------------------------------------------------------------------------------ | --------------------------------------------- |
| Cuenta            | `GET /me`                                                                                        | [Autenticación](/es/api/autenticacao)         |
| Bóvedas y páginas | `GET /vaults`, `GET/POST /vaults/{boveda}/pages`, `GET/PATCH/DELETE /vaults/{boveda}/pages/{id}` | [Bóvedas y páginas](/es/api/cofres-e-paginas) |
| Búsqueda          | `GET /vaults/{boveda}/search?q=`                                                                 | [Búsqueda](/es/api/busca)                     |
| Archivos          | `POST /vaults/{boveda}/files?name=`                                                              | [Adjuntos](/es/api/anexos)                    |
| Agenda            | `GET/POST /calendar/events`, `DELETE /calendar/events/{id}`                                      | [Agenda](/es/api/agenda)                      |

## Dónde viven los datos [#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](/es/api/copias-para-ia).

## Lo que ningún token hace [#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 [#para-agentes-de-ia]

El mapa completo de la documentación, con reglas y endpoints, está en [`/documentation/agents/raw.json`](https://wire.ia.br/documentation/agents/raw.json). Antes de actuar, lee [Agentes de IA](/es/api/agentes-de-ia).