Automatizaciones y API

Integraciones con otras herramientas

Aitana.app permite integrar tus datos con herramientas externas como Zapier, Make, n8n o sistemas propios, para automatizar tareas.

Algunos ejemplos de uso:

• Enviar movimientos desde una hoja de cálculo.
• Sincronizar ingresos y gastos con un sistema contable.
• Enviar un gasto cada vez que recibes una factura.

Clave API

Para usar integraciones necesitas una clave API, que se gestiona en la sección de Configuración.

• La clave completa solo se muestra una vez.
• Puedes rotarla o revocarla cuando quieras.

API v1

La API utiliza autenticación mediante Bearer token. Incluye la clave en la cabecera Authorization de cada petición:

Authorization: Bearer tu_clave_api

Límites de uso

La API permite un máximo de 60 peticiones por minuto por clave. Las cabeceras de respuesta incluyen información sobre el uso:

• X-RateLimit-Limit: límite por minuto.
• X-RateLimit-Remaining: peticiones restantes.
• X-RateLimit-Reset: momento en que se reinicia el contador.

Endpoints disponibles

Listar miembros

GET /api/v1/members

Devuelve la lista de miembros activos de tu cuenta.

Listar categorías

GET /api/v1/categories

Devuelve la lista de categorías activas de tu cuenta.

Crear un movimiento

POST /api/v1/transactions

Crea un movimiento real en el mes correspondiente a la fecha indicada. Requiere la cabecera Idempotency-Key para evitar duplicados si la petición se reintenta.

Documentación interactiva

Dentro de la app tienes una página con la documentación completa de la API, con ejemplos y detalles de uso actualizados.