Whisper Money

Buscar en la documentación

Busca páginas y secciones.

Registro de cambios

Cada cambio de la API que pueda afectar a tu código, del más reciente al más antiguo.

2026-11-11 · Gasto por etiqueta, uso de tarjetas y ahorro del mes

Tres cifras que enseña el panel de la app, para toda tu cuenta: GET /api/v1/analytics/spending-by-label ordena tus etiquetas por gasto en un rango frente al periodo anterior, GET /api/v1/analytics/credit-card-usage da cuánto de cada tarjeta de crédito está en uso, con su evolución día a día, y GET /api/v1/analytics/monthly-savings suma el mes en curso de tus objetivos de ahorro mensual y dice cómo fue el mes pasado. El Conector de IA lo tiene como las herramientas spending_by_label, get_credit_card_usage y get_monthly_savings.

2026-11-11 · Agregar transacciones

GET /api/v1/analytics/aggregate agrupa tus transacciones de un espacio por hasta dos dimensiones (día, semana, mes, año, categoría, etiqueta, cuenta o tipo) y devuelve por grupo su suma, número, media, importe más pequeño y más grande. Cada moneda va en su propio grupo y, al agrupar por periodo, salen todos los periodos del rango, también los que quedan a cero. El Conector de IA lo tiene como la herramienta aggregate_transactions.

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