Objetivo
Hacer llamadas API para leer y escribir datos de SUMA desde tus propias herramientas.
Antes de empezar
Necesitas una clave API (créala en Configuración). La API es RESTful con cuerpos de solicitud/respuesta en JSON. La documentación interactiva completa está disponible en /api/docs.
Pasos
1. Crea una clave API en Configuración.
2. Visita /api/docs para la referencia interactiva de la API (Redoc).
3. Haz solicitudes con: curl -H "Authorization: Bearer sb_tu_clave" https://suma.app/api/v1/transactions
4. Endpoints comunes:
- GET /api/v1/transactions — listar transacciones
- POST /api/v1/transactions — crear una transacción
- GET /api/v1/categories — listar categorías
- GET /api/v1/summary — obtener resumen de gastos
- GET /api/v1/export/json — exportar todos los datos
5. Las respuestas incluyen paginación: {"data": [...], "meta": {"page", "total", "total_pages"}}.
Resultado esperado
Puedes leer y escribir tus datos de SUMA desde scripts, hojas de cálculo o integraciones personalizadas.
Consejos
Consulta /api/docs para la especificación OpenAPI completa con todos los parámetros y esquemas de respuesta. El límite es 60 solicitudes/minuto. Los errores devuelven {"error": {"code": "...", "message": "..."}}.