Saltar al contenido principal

Quickstart en 5 minutos

En esta guía crearás un usuario, enviarás el intake financiero, registrarás un gasto y generarás el plan — todo en menos de 5 minutos.

Prerequisito​

Necesitas un client_id y client_secret. Contáctanos para obtener las credenciales.

# Genera tu token de autenticación
TOKEN=$(echo -n "tu_client_id:tu_client_secret" | base64)

Paso 1 — Crear un usuario​

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": "Carlos García",
    "language": "es"
  }'

Paso 2 — Enviar el intake financiero​

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"
  }'

Paso 3 — Registrar un gasto​

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": "Gasté $180 en el super y $50 en gasolina",
    "language": "es"
  }'

Respuesta — dos transacciones extraídas automáticamente:

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

Paso 4 — Generar el plan financiero​

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

Paso 5 — Chatear con el 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": "¿Cómo voy con mi meta de ahorro?"}'

Respuesta en español:

{
  "object": "chat_message",
  "data": {
    "reply": "¡Vas muy bien! Tus gastos este mes están dentro del presupuesto. Sigue así y alcanzarás tu meta de ahorro a tiempo. 💛"
  }
}

Próximos pasos​