La API de LUMA te permite acceder a tus datos financieros de forma programática. Crea integraciones personalizadas, automatiza flujos de trabajo o conecta LUMA con tus propias herramientas.
#Documentación completa de la API
Para consultar la documentación completa de la API, incluidos todos los endpoints, parámetros y ejemplos:
#Visión general
La API da acceso a:
- Transacciones
- Facturas
- Clientes
- Proyectos y registros de seguimiento de tiempo
- Informes financieros
- Documentos
- Cuentas bancarias
#Autenticación
La API de LUMA admite dos métodos de autenticación:
#Claves de API (para tus propios datos)
Para acceder a tus propios datos de LUMA desde scripts, automatizaciones o herramientas personales.
- Ve a Ajustes → Desarrollador
- Haz clic en Crear clave de API
- Dale un nombre descriptivo
- Copia la clave de inmediato (no volverás a verla)
Incluye tu clave de API en la cabecera Authorization:
Authorization: Bearer your-api-key-here
#OAuth 2.0 (para apps orientadas al usuario)
Para crear apps que accedan a los datos de LUMA de otros usuarios con su permiso.
- Crea una aplicación OAuth en Ajustes → Desarrollador
- Implementa el flujo de autorización OAuth
- Intercambia los códigos de autorización por access tokens
- Usa los access tokens en las peticiones a la API
#URL base
Todos los endpoints de la API usan:
https://api.midday.ai/v1
#Límites de peticiones
- Estándar: 100 peticiones por minuto
- Ráfaga: hasta 200 peticiones en ráfagas cortas
Si superas los límites de peticiones, recibirás una respuesta 429 Too Many Requests. Espera y vuelve a intentarlo con backoff exponencial.
#SDKs
#Paquete NPM
Instala el SDK de LUMA:
npm install @midday-ai/sdk
#Paquete MCP
Para integraciones con herramientas de IA:
npx @midday-ai/mcp
#Soporte
- Correo: support@midday.ai