Obsidian Planner API

REST API para integrar el planner con herramientas externas

Autenticación

Todas las rutas (excepto esta) requieren un API key en el header:

Authorization: Bearer <tu-api-key>

Generá tu key desde la sección Ajustes en calendario.exegestion.com.

Base URL

https://api.exegestion.com

Respuestas

Todas las respuestas son JSON. Éxito: { "data": ... } — Error: { "error": "mensaje" }

Tareas

GET /tasks

Lista de tareas. Todos los filtros son opcionales.

Query param	Tipo	Descripción
date	string	Fecha exacta YYYY-MM-DD
date_from	string	Desde fecha
date_to	string	Hasta fecha
done	boolean	true completadas / false pendientes
priority	string	high · medium · low
category	string	Nombre de categoría
limit	number	Máximo de resultados

GET /tasks?date=2026-03-26&done=false

POST /tasks

Crea una tarea.

{
  "text":     "Ir al gym",          // requerido
  "date":     "2026-03-26",         // requerido (YYYY-MM-DD)
  "priority": "high",               // opcional: high | medium | low  (default: medium)
  "category": "Salud"               // opcional: Personal | Trabajo | Salud | Finanzas | Otro
}

PATCH /tasks/:id

Actualiza campos de una tarea. Enviá solo los que querés cambiar.

{
  "done":     true,
  "text":     "Nuevo texto",
  "priority": "low",
  "category": "Trabajo",
  "date":     "2026-03-27"
}

DELETE /tasks/:id

Elimina una tarea. Devuelve { "data": { "deleted": "<id>" } }.

Gastos e Ingresos

GET /expenses

Lista de movimientos financieros.

Query param	Tipo	Descripción
date	string	Fecha exacta YYYY-MM-DD
date_from	string	Desde fecha
date_to	string	Hasta fecha
type	string	income o expense
category	string	Nombre de categoría
limit	number	Máximo de resultados

POST /expenses

Registra un gasto o ingreso.

{
  "type":        "expense",         // requerido: "income" o "expense"
  "amount":      1500,              // requerido (número positivo)
  "description": "Almuerzo",        // requerido
  "date":        "2026-03-26",      // requerido (YYYY-MM-DD)
  "category":    "Alimentación"     // opcional (default: "Otro")
}

DELETE /expenses/:id

Elimina un movimiento financiero.

Resúmenes

GET /summary/today

Resumen del día de hoy: tareas y finanzas.

{
  "data": {
    "date": "2026-03-26",
    "tasks":    { "total": 3, "pending": 1, "done": 2, "items": [...] },
    "finances": { "income": 50000, "expense": 1500, "balance": 48500, "items": [...] }
  }
}

GET /summary/monthly?year=2026&month=3

Reporte financiero mensual con totales y breakdown por categoría.

Ejemplo rápido

curl https://api.exegestion.com/tasks?done=false \
  -H "Authorization: Bearer tu-api-key"

curl -X POST https://api.exegestion.com/tasks \
  -H "Authorization: Bearer tu-api-key" \
  -H "Content-Type: application/json" \
  -d '{"text":"Estudiar inglés","date":"2026-03-26","priority":"high"}'