Pular para o conteúdo principal

Changelog

Todas as mudanças notáveis na API Ozzie são documentadas aqui.

v2.1.0 — 16 de maio de 2026​

Channel API e autenticação OTP.

Esta versão introduz a Channel API (channel.ozzieapp.com) como o ponto de integração principal para todos os aplicativos para consumidores, juntamente com um sistema completo de autenticação OTP para usuários finais.

Novo: Channel API​

Os aplicativos para consumidores agora chamam exclusivamente channel.ozzieapp.com/v1. A Channel API é stateful — gerencia usuários, códigos OTP, estado de onboarding, histórico de chat, transações, metas e alertas de gastos. Ela faz proxy de requisições de inteligência para a camada interna em api.ozzieapp.com sem expô-la aos consumidores.

Novos endpoints​

MétodoCaminhoDescrição
POST/v1/auth/otp/requestSolicitar um código OTP de 6 dígitos via WhatsApp ou e-mail
POST/v1/auth/otp/verifyVerificar OTP — retorna user_id e onboarding_stage
GET/v1/users/:user_id/profilePerfil de usuário do canal com onboarding_stage e plan_speed
PATCH/v1/users/:user_id/onboarding/completeAvançar onboarding de plan → active
GET/v1/users/:user_id/chat/messagesRecuperar histórico de chat persistente

Sistema OTP​

  • Códigos de 6 dígitos com TTL de 10 minutos, uso único, hash bcrypt
  • Detecta automaticamente o canal de entrega a partir do formato do identificador (telefone E.164 → WhatsApp, endereço de e-mail → e-mail)
  • Novos códigos de erro: INVALID_CODE (400) e CODE_EXPIRED (400)

Atualizações no registro de usuários​

POST /v1/users agora aceita os campos phone (E.164) e email. Retorna 409 CONFLICT se o external_user_id já existir. O campo external_user_id no corpo não deve incluir o prefixo "external:".

Banco de dados​

As tabelas do aplicativo web legado foram removidas. O banco de dados ativo agora consiste em tabelas da channel-api (channel_users, otp_codes, chat_messages, transactions, user_goals, money_move_tasks, spending_alerts) e tabelas da intelligence-api (api_clients, api_rate_windows, users, financial_intake_results, financial_plans, personality_questions, money_moves_catalog).

v2.0.0 — 15 de maio de 2026​

Redesign da plataforma: camada de inteligência sem estado.

Esta versão introduz o ozzie-openapi como a API de inteligência focada. Todos os endpoints são sem estado — os chamadores fornecem contexto completo e recebem inteligência computada em retorno.

Mudanças incompatíveis​

Sistema de personalidade substituído​

O antigo endpoint POST /plan/personalize com quatro tipos (optimizer, planner, avoider, spender) foi substituído por um sistema de quiz de personalidade com quatro novos tipos:

Tipo antigoNovo tipo
optimizerHOTSHOT
plannerSTOCKPILER
avoiderINDEPENDENT
spenderGIVER

A personalidade agora é pontuada a partir de um quiz (GET /v1/personality/questions e POST /v1/personality/score) e passada explicitamente para todas as chamadas de inteligência relevantes. Você não chama mais POST /plan/personalize separadamente.

Sistema de envelopes​

As antigas strings livres de envelope (ex.: "Dia a Dia", "Estilo de Vida") são substituídas por chaves padronizadas em inglês:

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

URL base​

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

Caminho do endpoint de chat​

O endpoint de chat agora é POST /v1/users/{user_id}/chat/completion. O campo de resposta reply foi renomeado para content. O endpoint é sem estado — passe o histórico da conversa em history.

Novos endpoints​

  • GET /v1/personality/questions — Catálogo do quiz
  • POST /v1/personality/score — Pontuação de personalidade sem estado (retorna o tipo, não armazena)
  • POST /v1/money-moves/generate — Geração de movimentos sem estado (aceita personality_type + plan_tier)
  • POST /v1/transactions/parse — Análise de transação com IA sem estado

Novos recursos​

Quiz de personalidade​

Um quiz de 10 perguntas determina um de quatro tipos de personalidade (HOTSHOT, STOCKPILER, GIVER, INDEPENDENT). Sua aplicação armazena o resultado e o passa para a geração de plano, ponderação de envelopes, geração de movimentos financeiros e completude de chat.

Ponderação de envelopes por personalidade​

As alocações flexíveis de envelopes agora são ponderadas pelo tipo de personalidade. STOCKPILER recebe +5% de alocação de meta antes dos demais envelopes flexíveis serem distribuídos. INDEPENDENT recebe peso igual de 25% em todos os quatro envelopes flexíveis. Veja o Sistema de Envelopes para a tabela completa de pesos.

Tier de plano​

Os planos agora incluem um campo plan_tier (ex.: "20/80", "30/70") indicando a proporção entre poupança e gastos. Passe isso para a geração de movimentos financeiros.

v1.0.0 — 5 de maio de 2025​

Lançamento público inicial da API Ozzie.

Recursos no lançamento​

  • Usuários, intake financeiro, geração de plano, análise de transações (texto, imagem, PDF, planilha), money moves, chat
  • Suporte multilíngue: en, pt, es
  • Planos adaptados à personalidade via POST /plan/personalize (optimizer, planner, avoider, spender)
  • Paginação baseada em cursor em todos os endpoints de lista
  • Rate limiting com headers Retry-After e X-RateLimit-*
Política de sem mudanças incompatíveis silenciosas

A API Ozzie nunca altera tipos de campos, remove campos ou muda comportamentos sem um incremento de versão major. Todas as mudanças incompatíveis recebem pelo menos 90 dias de aviso de depreciação e um guia de migração publicado.