Registro de cambios
Cada cambio de la API que pueda afectar a tu código, del más reciente al más antiguo.
2026-10-28 · v1: primera versión
La primera versión pública de la API, en https://whisper.money/api/v1. Cubre
todo lo que puede hacer el Conector de IA, y
añade un endpoint para leer por su id una cuenta, una transacción, una
categoría, una etiqueta, una regla de automatización, un presupuesto o un
objetivo de ahorro:
- Espacios: lista los espacios a los que tienes acceso.
- Cuentas y sus saldos: lista, lee, crea y actualiza cuentas; lista y registra saldos.
- Transacciones: busca, lee, crea, actualiza, categoriza, etiqueta, divide, vuelve a unir una división y borra.
- Categorías y etiquetas: lista, lee, crea, actualiza y borra.
- Reglas de automatización: lista, lee, crea, actualiza, borra y aplica una a las transacciones que ya existen.
- Presupuestos: lista, lee, crea, actualiza y borra.
- Objetivos de ahorro: lista, lee, crea y actualiza.
- Analítica: flujo de caja, patrimonio y gasto por categoría.
- Medallas: lista tus medallas.
Los permisos son los de la app: la API solo llega a tus propios datos, también
en un espacio compartido. La cuenta, transacción,
categoría, etiqueta, regla u objetivo de otro miembro responde 404, y su id
se rechaza en el cuerpo de una petición. Igual que en la app, una transacción
del banco o de una importación se puede borrar y mover de fecha, pero su
importe y sus nombres se quedan como los envió el banco.
La autenticación funciona con tokens personales o apps OAuth, y toda la API está descrita en la especificación OpenAPI.
Cómo funcionarán las versiones
/api/v1 se queda como está. No quitamos campos ni endpoints, ni cambiamos lo
que significan.
Cuando haga falta un cambio incompatible, llegará como una versión con fecha que
eliges con la cabecera Whisper-Version, y las peticiones sin la cabecera
seguirán comportándose como hoy. Esa cabecera aún no está activa: enviarla ahora
no tiene efecto. Los cambios que no pueden romper un cliente, como un endpoint
nuevo o un campo nuevo en una respuesta, se añaden directamente a la v1 y se
anotan aquí.