Cree un token de GanttFather API, llame a la v1 REST API de forma segura, maneje las cuotas y la idempotencia y elija entre REST y MCP.
GanttFather REST API expone operaciones versionadas de proyectos, tareas, dependencias, miembros y recursos para scripts e integraciones. Autentíquese con un token GanttFather, envíe un encabezado de Agente de usuario que no esté vacío, comience con llamadas de lectura y use una clave de idempotencia al crear una tarea o recurso que se pueda volver a intentar.
Comportamiento de API verificado el 7 de agosto de 2026. Trate el referencia en vivo de API como el contrato a nivel de punto final.
¿Qué puedes automatizar con GanttFather API?
La versión 1 API admite flujos de trabajo de integración de programación comunes:
- enumerar proyectos accesibles e inspeccionar un proyecto
- enumerar y leer tareas, miembros, recursos y dependencias
- crear, actualizar parcialmente, reordenar y eliminar tareas
- agregar o eliminar dependencias de tareas
- crear, actualizar y eliminar recursos
- adjunte su propia asignación entre un registro externo y una identificación de GanttFather
El API público no es la misma superficie que los API internos del navegador. Utilice únicamente campos de respuesta y puntos finales v1 documentados.
¿Cómo se crea y utiliza un token de API?
Abra GanttFather, vaya a Configuración → Agentes AI y API y cree un token con el alcance y permiso útiles más pequeños. Copie el token sin formato cuando se muestre y guárdelo en un administrador secreto; GanttFather no almacena el valor bruto para mostrarlo más tarde.
Luego sigue esta secuencia:
- Lee el guía de autenticación.
- Llamar enumerar proyectos para encontrar una identificación de proyecto accesible.
- Lea las tareas antes de intentar escribirlas.
- Cree una tarea de prueba desechable.
- Agregue paginación, reintento y manejo de cuotas antes de un trabajo masivo.
Cada solicitud debe incluir el token Portador y un User-Agent no vacío que identifique al cliente. Un agente de usuario faltante se rechaza antes del manejo normal del punto final.
¿Qué normas de seguridad son importantes para la escritura?
Utilice actualizaciones parciales solo para los campos que posee su integración. Lea el estado actual antes de cambiarlo, registre identificadores estables e información de seguimiento, y no convierta cada campo externo en una sobrescritura incondicional.
Para la creación de tareas y recursos, envíe una Clave de Idempotencia cuando un tiempo de espera o una falla de la red puedan provocar un reintento. Reutilizar la clave con la misma solicitud devuelve el resultado anterior; reutilizarlo con una solicitud diferente es un conflicto. Las actualizaciones y eliminaciones tienen su semántica documentada y no aceptan esa clave de solo creación como mecanismo de deduplicación universal.
Las dependencias y la jerarquía son preocupaciones separadas. La reordenación es la forma autorizada de cambiar la ubicación de los padres; los puntos finales de dependencia modelan las relaciones predecesoras. Valide ambos en lugar de derivar uno del otro.
¿Cuáles son los límites de tarifa y cuota diaria?
La protección predeterminada es 60 solicitudes por minuto por token autenticado y 5000 solicitudes por día por token. Una respuesta limitada utiliza HTTP 429 y proporciona información de reintento. comprobar la corriente documentación sobre límites de tarifas y cuotas antes de planificar una carga de trabajo de producción porque los límites operativos pueden cambiar.
Reduzca el volumen de solicitudes paginando correctamente, leyendo en lotes, almacenando en caché los identificadores estables y enviando una actualización parcial en lugar de una secuencia de actualizaciones por campo. Un bucle de reintento debe respetar el reintento posterior y utilizar un retroceso exponencial limitado con fluctuación.
¿Cuándo deberías usar REST en lugar de MCP?
Utilice REST cuando el código de aplicación determinista necesite recursos versionados de HTTP, respuestas de error explícitas y comportamiento de reintento controlado. Utilice el MCP servidor cuando un cliente de IA como Claude debería invocar herramientas de proyecto de nivel superior a través de Model Context Protocol.
Ambos pueden usar el carril de tokens de GanttFather, pero sus operaciones y entradas de idempotencia no son intercambiables. Una integración de API debe seguir la referencia de REST; un agente debe seguir las descripciones de las herramientas de MCP.
¿Qué es un patrón de primera integración segura?
Comience con una dirección y un propietario para cada campo:
| paso | Comportamiento recomendado |
|---|---|
| Descubrir | Enumere los proyectos y registre la identificación del proyecto seleccionado |
| leer | Hojee las tareas actuales y cree un mapa de identificación |
| Comparar | Calcular un conjunto de cambios sin escribir |
| Revisión | Registro previsto creado, actualizado y eliminado |
| escribir | Aplicar la mutación admitida más pequeña |
| verificar | Lea el resultado y registre la identificación devuelta. |
No reclame “sincronización” hasta que se definan la propiedad del conflicto, las reglas de eliminación, los reintentos y la recuperación.
¿Cuándo deberías aprovechar los GanttFather API?
Utilice API cuando un formulario, canal de implementación, portal de clientes o sistema interno necesite acceso repetible a los mismos datos del proyecto que su equipo ve en GanttFather. El primer caso de uso más confiable es limitado; por ejemplo, crear un hito de lanzamiento después de la implementación y luego expandirlo después de observar fallas y reintentos reales.
API no decide qué sistema posee un campo ni hace que un flujo de trabajo multisistema esté libre de conflictos. Su integración debe definir esas reglas.
Crear un proyecto de GanttFather, emita un token con privilegios mínimos y pruebe con datos desechables antes de conectar los registros de producción.
Preguntas frecuentes
¿Está incluido el acceso de API en el nivel gratuito?
El acceso de API está disponible actualmente en los planes de GanttFather. Aún se aplican límites de capacidad y protección; verificar el página de precios y API documentación de cuota para los términos actuales.
¿Cómo se ve un token de GanttFather API?
Los tokens utilizan el formato de token GanttFather y se presentan como credenciales de portador. Nunca envíe un token al control de fuente ni lo incluya en un registro público.
¿El User-Agent es opcional?
No para solicitudes normales de v1. Envíe un valor no vacío que identifique su integración, como el nombre y la versión del producto.
¿Cada solicitud debería incluir una clave de idempotencia?
No. Úselo para operaciones de creación documentadas cuando se pueda volver a intentar la misma solicitud. No es una versión de propósito general ni un encabezado de concurrencia.
¿Pueden los API configurar las fuentes de integración de Azure DevOps?
Los datos públicos del proyecto v1 API y la integración Azure DevOps del producto son superficies separadas. No asuma que existe un punto final de integración no documentado.
¿Dónde está la documentación de OpenAPI?
Empezar desde el GanttFather API introducción y siga los enlaces de referencia para autenticación, puntos finales, esquemas y errores.
