Por qué importa una API REST
La nueva referencia de la API da a los equipos una forma directa de construir sobre GanttFather. En lugar de exportar una hoja de cálculo, editarla en otra parte y volver a importarla, tus scripts pueden leer y escribir los mismos datos de proyecto que tu equipo ve en la app.
Eso importa para equipos de operaciones, agencias, fundadores y quienes crean herramientas internas. Un diagrama de Gantt es más útil cuando se mantiene cerca del trabajo. La API lo hace posible desde tareas programadas, dashboards, portales de clientes, pipelines de despliegue e integraciones ligeras.
Qué puedes automatizar
La primera superficie pública de la API se centra en los datos de proyecto que la gente pide automatizar con más frecuencia:
- listar los proyectos a los que tu token puede acceder
- leer, crear, actualizar, reordenar y eliminar tareas
- mantener estado y progreso sincronizados
- definir responsables y dependencias de tareas
- listar miembros y recursos
- crear, actualizar o eliminar recursos no humanos como equipo, salas y partidas de presupuesto
En la práctica, puedes crear un plan de lanzamiento desde un formulario interno, actualizar un hito cuando termina un despliegue o reflejar trabajo seleccionado de otra herramienta en una línea de tiempo de GanttFather.
Cómo empezar
Abre GanttFather, ve a Settings → AI Agents & API y crea un token. Luego:
- Lee la guía de autenticación.
- Llama a list projects para encontrar el id del proyecto.
- Prueba create task con una tarea pequeña de prueba.
- Usa pagination y rate limits antes de ejecutar sincronizaciones masivas.
curl https://api.ganttfather.com/v1/projects \
-H "Authorization: Bearer glt_your_token" \
-H "User-Agent: your-integration-name/1.0"El User-Agent es intencional. Ayuda a soporte a rastrear integraciones reales, depurar casos raros y mantener el tráfico de API separado del tráfico anónimo del navegador.
API versus MCP
Usa la API REST cuando estés escribiendo código y quieras endpoints HTTP estables. Usa la guía del servidor MCP cuando quieras que un asistente de IA como Claude, ChatGPT, Cursor o Windsurf trabaje con tu proyecto mediante herramientas de más alto nivel.
Ambos usan la misma zona de tokens en GanttFather y ambos están incluidos para todos los usuarios. La diferencia es la interfaz: REST es para tu programa; MCP es para tu agente.
Precios y límites
El acceso a la API está incluido en todos los planes. La página de precios mantiene la misma regla: cada función está disponible desde el primer día, y las mejoras pagas solo agregan capacidad — más proyectos propios o más editores activos.
Los límites predeterminados de la API son 60 solicitudes por minuto por token y 5,000 solicitudes por día por token. Las solicitudes limitadas devuelven 429 con Retry-After; las respuestas de cuota diaria incluyen X-Quota-Remaining. Para sincronizaciones grandes, agrupa escrituras y evita bucles de actualización campo por campo. Consulta Rate limits & quotas.
El patrón de integración
Las integraciones más limpias suelen seguir esta forma:
- mantener un pequeño mapeo entre el id de tu sistema y el id de la tarea en GanttFather
- leer el estado actual del proyecto antes de escribir
- enviar actualizaciones parciales solo para los campos que cambiaron
- usar claves de idempotencia en operaciones de creación cuando haya reintentos
- registrar el trace id de GanttFather cuando algo falle
Empieza pequeño: lista proyectos, crea una tarea, actualízala y luego conecta el flujo con tu propio sistema.
Empieza con un token y mantén la referencia abierta junto a tu editor.