API Reference v1.0

Documentacion de la API

Integra FinanzasAI en tus aplicaciones con nuestra API REST completa. Autenticacion simple, respuestas JSON, documentacion detallada.

Inicio Rapido

1. Obtener API Key

Ve a Configuracion -> API Keys en tu dashboard

2. Autenticar

Incluye tu key en el header Authorization

3. Hacer Requests

Usa los endpoints para gestionar datos

Base URL

https://finanzasapp.luxoradevs.com/api

Autenticacion

Incluye tu API Key en el header de cada solicitud:

Authorization: Bearer sk_live_tu_api_key_aqui

Ejemplo Completo (cURL)

curl -X GET "https://finanzasapp.luxoradevs.com/api/transactions?limit=10" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

Endpoints

Ejemplos de Codigo

JavaScriptListar transacciones

const response = await fetch('https://finanzasapp.luxoradevs.com/api/transactions', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_live_xxxxxxxxxxxxx',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data); // { transactions: [...], pagination: {...} }

JavaScriptCrear transaccion

const response = await fetch('https://finanzasapp.luxoradevs.com/api/transactions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_xxxxxxxxxxxxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    type: 'EXPENSE',
    amount: 50000,
    description: 'Almuerzo',
    date: '2024-01-15',
    accountId: 'acc_xxxxx',
    categoryId: 'cat_xxxxx'
  })
});

const newTransaction = await response.json();

PythonObtener balance de cuentas

import requests

headers = {
    'Authorization': 'Bearer sk_live_xxxxxxxxxxxxx',
    'Content-Type': 'application/json'
}

response = requests.get(
    'https://finanzasapp.luxoradevs.com/api/accounts',
    headers=headers
)

accounts = response.json()
for account in accounts:
    print(f"{account['name']}: {account['balance']:,.0f} COP")

PythonChat con asistente IA

import requests

response = requests.post(
    'https://finanzasapp.luxoradevs.com/api/ai/chat',
    headers={'Authorization': 'Bearer sk_live_xxxxxxxxxxxxx'},
    json={'message': 'Cuanto gaste en restaurantes este mes?'}
)

result = response.json()
print(result['response'])
# "Este mes has gastado $245.000 en restaurantes..."

Codigos de Error

CodigoNombreDescripcion
400Bad RequestDatos invalidos o faltantes en la solicitud
401UnauthorizedAPI Key invalida o no proporcionada
403ForbiddenNo tienes permisos para este recurso
404Not FoundEl recurso solicitado no existe
429Too Many RequestsExcediste el limite de solicitudes (100/min)
500Internal Server ErrorError interno del servidor

Limites y Buenas Practicas

Rate Limits

  • Solicitudes por minuto:100
  • Solicitudes por hora:3,000
  • Solicitudes por dia:50,000

Buenas Practicas

  • • Usa paginacion para listas grandes
  • • Cachea respuestas cuando sea posible
  • • Maneja errores 429 con retry exponencial
  • • Nunca expongas tu API Key en el frontend
  • • Rota tus keys periodicamente

Listo para integrar?

Crea tu cuenta y genera tu primera API Key en minutos. Plan Business incluye acceso completo a la API.