Saltar al contenido principal

Changelog

Todos los cambios notables en la API de Ozzie están documentados aquí.

v2.1.0 — 16 de mayo de 2026​

Channel API y autenticación OTP.

Esta versión introduce la Channel API (channel.ozzieapp.com) como el punto de integración principal para todas las aplicaciones de consumo, junto con un sistema completo de autenticación OTP para usuarios finales.

Nuevo: Channel API​

Las aplicaciones de consumo ahora llaman exclusivamente a channel.ozzieapp.com/v1. La Channel API es stateful — gestiona usuarios, códigos OTP, estado de onboarding, historial de chat, transacciones, metas y alertas de gasto. Hace proxy de las solicitudes de inteligencia a la capa interna en api.ozzieapp.com sin exponerla a los consumidores.

Nuevos endpoints​

MétodoRutaDescripción
POST/v1/auth/otp/requestSolicitar un código OTP de 6 dígitos por WhatsApp o correo
POST/v1/auth/otp/verifyVerificar OTP — devuelve user_id y onboarding_stage
GET/v1/users/:user_id/profilePerfil de usuario del canal con onboarding_stage y plan_speed
PATCH/v1/users/:user_id/onboarding/completeAvanzar el onboarding de plan → active
GET/v1/users/:user_id/chat/messagesRecuperar historial de chat persistente

Sistema OTP​

  • Códigos de 6 dígitos con TTL de 10 minutos, de uso único, hasheados con bcrypt
  • Detección automática del canal de entrega a partir del formato del identificador (teléfono E.164 → WhatsApp, dirección de correo → email)
  • Nuevos códigos de error: INVALID_CODE (400) y CODE_EXPIRED (400)

Actualizaciones en el registro de usuarios​

POST /v1/users ahora acepta los campos phone (E.164) y email. Devuelve 409 CONFLICT si el external_user_id ya existe. El campo external_user_id en el cuerpo no debe incluir el prefijo "external:".

Base de datos​

Las tablas de la aplicación web legacy fueron eliminadas. La base de datos activa ahora comprende tablas de la channel-api (channel_users, otp_codes, chat_messages, transactions, user_goals, money_move_tasks, spending_alerts) y tablas de la intelligence-api (api_clients, api_rate_windows, users, financial_intake_results, financial_plans, personality_questions, money_moves_catalog).

v2.0.0 — 15 de mayo de 2026​

Rediseño de la plataforma: capa de inteligencia sin estado.

Esta versión introduce ozzie-openapi como la API de inteligencia enfocada. Todos los endpoints son sin estado — quienes llaman proveen contexto completo y reciben inteligencia computada a cambio.

Cambios incompatibles​

Sistema de personalidad reemplazado​

El antiguo endpoint POST /plan/personalize con cuatro tipos (optimizer, planner, avoider, spender) fue reemplazado por un sistema de quiz de personalidad con cuatro nuevos tipos:

Tipo anteriorTipo nuevo
optimizerHOTSHOT
plannerSTOCKPILER
avoiderINDEPENDENT
spenderGIVER

Ahora la personalidad se puntúa a partir de un quiz (GET /v1/personality/questions y POST /v1/personality/score) y se pasa explícitamente a todas las llamadas de inteligencia relevantes. Ya no se llama a POST /plan/personalize por separado.

Sistema de sobres​

Los antiguos strings de envelope en texto libre (ej., "Dia a Dia", "Estilo de Vida") fueron reemplazados por claves en inglés estandarizadas:

Valor anteriorClave nueva
Contasbills
Dia a Diadaily_living
Saúde & Bem-estarhealth_wellness
Estilo de Vidalifestyle
Pessoaspeople
Seu Futurofuture

URL base​

Nueva URL base: https://api.ozzieapp.com/v1

Ruta del endpoint de chat​

El endpoint de chat ahora es POST /v1/users/{user_id}/chat/completion. El campo de respuesta reply fue renombrado a content. El endpoint es sin estado — pasa el historial de conversación en history.

Nuevos endpoints​

  • GET /v1/personality/questions — Catálogo del quiz
  • POST /v1/personality/score — Puntuación de personalidad sin estado (devuelve el tipo, no lo almacena)
  • POST /v1/money-moves/generate — Generación de movimientos sin estado (acepta personality_type + plan_tier)
  • POST /v1/transactions/parse — Análisis de transacciones IA sin estado

Nuevas funcionalidades​

Quiz de personalidad​

Un quiz de 10 preguntas determina uno de cuatro tipos de personalidad (HOTSHOT, STOCKPILER, GIVER, INDEPENDENT). Tu aplicación almacena el resultado y lo pasa a la generación de planes, ponderación de sobres, generación de movimientos de dinero y completado de chat.

Ponderación de sobres por personalidad​

Las asignaciones flexibles de sobres ahora se ponderan según el tipo de personalidad. STOCKPILER recibe +5% de asignación a metas antes de distribuir los demás sobres flexibles. INDEPENDENT recibe un peso equitativo del 25% en los cuatro sobres flexibles. Consulta Sistema de Sobres para ver la tabla completa de pesos.

Tier del plan​

Los planes ahora incluyen un campo plan_tier (ej., "20/80", "30/70") que indica el ratio ahorro-gasto. Pásalo a la generación de movimientos de dinero.

v1.0.0 — 5 de mayo de 2025​

Lanzamiento público inicial de la API de Ozzie.

Funcionalidades en el lanzamiento​

  • Usuarios, intake financiero, generación de planes, análisis de transacciones (texto, imagen, PDF, hoja de cálculo), movimientos de dinero, chat
  • Soporte multilingüe: en, pt, es
  • Planes conscientes de personalidad mediante POST /plan/personalize (optimizer, planner, avoider, spender)
  • Paginación basada en cursor en todos los endpoints de lista
  • Límite de tasa con encabezados Retry-After y X-RateLimit-*
Política de no-cambios-incompatibles-silenciosos

La API de Ozzie nunca cambia tipos de campos, elimina campos ni altera comportamientos sin un incremento de versión mayor. Todos los cambios incompatibles reciben al menos 90 días de aviso de deprecación y una guía de migración publicada.