Pular para o conteúdo principal

Quickstart em 5 minutos

Neste guia você vai criar um usuário, enviar o intake financeiro, registrar uma despesa e gerar o plano — tudo em menos de 5 minutos.

Pré-requisito​

Você precisa de um client_id e client_secret. Entre em contato para obter as credenciais.

# Gere seu token de autenticação
TOKEN=$(echo -n "seu_client_id:seu_client_secret" | base64)

Passo 1 — Criar um usuário​

curl -X POST https://api.ozzieapp.com/v1/users \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "external_user_id": "user_123",
    "name": "Ana Silva",
    "language": "pt"
  }'

Resposta:

{
  "object": "user",
  "data": {
    "id": "9f4e2c1a-3b5d-4e7f-8a9b-0c1d2e3f4a5b",
    "external_user_id": "user_123",
    "name": "Ana Silva",
    "language": "pt",
    "onboarding_stage": "financial_intake",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

Passo 2 — Enviar o intake financeiro​

curl -X POST https://api.ozzieapp.com/v1/users/user_123/financial-intake \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "monthly_income": 5000,
    "monthly_expenses": 3200,
    "financial_goal": "savings"
  }'

Passo 3 — Registrar uma despesa​

curl -X POST https://api.ozzieapp.com/v1/users/user_123/transactions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "text",
    "content": "Gastei R$180 no supermercado e R$50 de gasolina",
    "language": "pt"
  }'

Resposta — duas transações extraídas automaticamente:

{
  "object": "transaction_list",
  "data": {
    "transactions": [
      {
        "amount_cents": 18000,
        "currency": "BRL",
        "category": "food",
        "description": "Supermercado",
        "transaction_date": "2024-01-15",
        "ai_confidence": 0.97
      },
      {
        "amount_cents": 5000,
        "currency": "BRL",
        "category": "transport",
        "description": "Gasolina",
        "transaction_date": "2024-01-15",
        "ai_confidence": 0.95
      }
    ]
  }
}

Passo 4 — Gerar o plano financeiro​

curl -X POST https://api.ozzieapp.com/v1/users/user_123/plan \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Passo 5 — Conversar com o coach​

curl -X POST https://api.ozzieapp.com/v1/users/user_123/chat/messages \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "Como estou indo com minha meta de poupança?"}'

Resposta em português:

{
  "object": "chat_message",
  "data": {
    "reply": "Você está indo bem! Suas despesas este mês estão dentro do orçamento. Continue assim e você vai atingir sua meta de poupança no prazo. 💛"
  }
}

Próximos passos​