Erstellen Sie ein GanttFather API-Token, rufen Sie v1 REST API sicher auf, verwalten Sie Quoten und Idempotenz und wählen Sie zwischen REST und MCP.
GanttFather REST API macht versionierte Projekt-, Aufgaben-, Abhängigkeits-, Mitglieds- und Ressourcenvorgänge für Skripte und Integrationen verfügbar. Authentifizieren Sie sich mit einem GanttFather-Token, senden Sie einen nicht leeren User-Agent-Header, beginnen Sie mit Leseaufrufen und verwenden Sie einen Idempotency-Key, wenn Sie eine Aufgabe oder Ressource erstellen, die wiederholt werden kann.
Das Verhalten von API wurde am 7. August 2026 überprüft. Behandeln Sie das Live-API-Referenz als Vertrag auf Endpunktebene.
Was können Sie mit GanttFather API automatisieren?
Die Version 1 API unterstützt gängige Arbeitsabläufe zur Zeitplanintegration:
- Verfügbare Projekte auflisten und ein Projekt prüfen
- Aufgaben, Mitglieder, Ressourcen und Abhängigkeiten auflisten und lesen
- Aufgaben erstellen, teilweise aktualisieren, neu anordnen und löschen
- Aufgabenabhängigkeiten hinzufügen oder entfernen
- Ressourcen erstellen, aktualisieren und löschen
- Fügen Sie Ihre eigene Zuordnung zwischen einem externen Datensatz und einer GanttFather-ID hinzu
Das öffentliche API ist nicht dieselbe Oberfläche wie das interne API des Browsers. Verwenden Sie nur dokumentierte v1-Endpunkte und Antwortfelder.
Wie erstellt und verwendet man ein API-Token?
Öffnen Sie GanttFather, gehen Sie zu Einstellungen → KI-Agenten & API und erstellen Sie ein Token mit dem kleinsten nützlichen Umfang und der geringsten Berechtigung. Kopieren Sie das Rohtoken, wenn es angezeigt wird, und speichern Sie es in einem geheimen Manager. GanttFather speichert den Rohwert nicht zur späteren Anzeige.
Folgen Sie dann dieser Reihenfolge:
- Lesen Sie die Authentifizierungsanleitung.
- Rufen Sie an Projekte auflisten um eine zugängliche Projekt-ID zu finden.
- Lesen Sie Aufgaben, bevor Sie einen Schreibversuch unternehmen.
- Erstellen Sie eine Einweg-Testaufgabe.
- Fügen Sie vor einem Massenauftrag Paginierung, Wiederholung und Kontingentverwaltung hinzu.
Jede Anfrage muss das Bearer-Token und einen nicht leeren User-Agent enthalten, der den Client identifiziert. Ein fehlender User-Agent wird vor der normalen Endpunktverarbeitung abgelehnt.
Welche Sicherheitsregeln sind beim Schreiben wichtig?
Verwenden Sie Teilaktualisierungen nur für Felder, die Ihrer Integration gehören. Lesen Sie den aktuellen Status, bevor Sie ihn ändern, protokollieren Sie stabile IDs und Trace-Informationen und wandeln Sie nicht jedes externe Feld in ein bedingungsloses Überschreiben um.
Senden Sie für die Aufgaben- und Ressourcenerstellung einen Idempotency-Key, wenn ein Timeout oder ein Netzwerkfehler zu einem erneuten Versuch führen kann. Die Wiederverwendung des Schlüssels mit derselben Anfrage gibt das vorherige Ergebnis zurück; Die Wiederverwendung mit einer anderen Anfrage ist ein Konflikt. Aktualisierungen und Löschvorgänge haben ihre dokumentierte Semantik und akzeptieren diesen Nur-Erstellungs-Schlüssel nicht als universellen Deduplizierungsmechanismus.
Abhängigkeiten und Hierarchie sind getrennte Anliegen. Die Neuordnung ist die zulässige Methode zur Änderung der übergeordneten Platzierung. Abhängigkeitsendpunkte modellieren Vorgängerbeziehungen. Validieren Sie beide, anstatt das eine vom anderen abzuleiten.
Wie hoch sind die Raten- und Tageskontingentgrenzen?
Der Standardschutz beträgt 60 Anfragen pro Minute und authentifiziertem Token und 5.000 Anfragen pro Tag und Token. Eine begrenzte Antwort verwendet HTTP 429 und stellt Wiederholungsinformationen bereit. Überprüfen Sie den Strom Ratenlimits und Quotendokumentation Bevor Sie eine Produktionsauslastung planen, da sich die Betriebsgrenzen ändern können.
Reduzieren Sie das Anforderungsvolumen, indem Sie korrekt paginieren, Stapel einlesen, stabile IDs zwischenspeichern und eine Teilaktualisierung anstelle einer Folge von Aktualisierungen pro Feld senden. Eine Wiederholungsschleife sollte Retry-After berücksichtigen und einen begrenzten exponentiellen Backoff mit Jitter verwenden.
Wann sollten Sie REST anstelle von MCP verwenden?
Verwenden Sie REST, wenn deterministischer Anwendungscode versionierte HTTP-Ressourcen, explizite Fehlerantworten und kontrolliertes Wiederholungsverhalten benötigt. Benutzen Sie die MCP Server wenn ein KI-Client wie Claude über Model Context Protocol übergeordnete Projekttools aufrufen soll.
Beide können die Token-Lane von GanttFather verwenden, ihre Operationen und Idempotenz-Eingaben sind jedoch nicht austauschbar. Eine API-Integration sollte der REST-Referenz folgen; Ein Agent sollte die MCP-Toolbeschreibungen befolgen.
Was ist ein sicheres Erstintegrationsmuster?
Beginnen Sie mit einer Richtung und einem Eigentümer für jedes Feld:
| Schritt | Empfohlenes Verhalten |
|---|---|
| Entdecken | Listen Sie Projekte auf und notieren Sie die ausgewählte Projekt-ID |
| Lesen | Blättern Sie durch aktuelle Aufgaben und erstellen Sie eine ID-Karte |
| Vergleichen | Berechnen Sie einen Änderungssatz, ohne zu schreiben |
| Rezension | Protokoll beabsichtigter Erstellungen, Aktualisierungen und Löschungen |
| Schreiben | Wenden Sie die kleinste unterstützte Mutation an |
| Verifizieren | Lesen Sie das Ergebnis und notieren Sie die zurückgegebene ID |
Beanspruchen Sie keine „Synchronisierung“, bis Konflikteigentum, Löschregeln, Wiederholungsversuche und Wiederherstellung definiert sind.
Wann sollten Sie auf GanttFather API aufbauen?
Verwenden Sie API, wenn ein Formular, eine Bereitstellungspipeline, ein Kundenportal oder ein internes System wiederholbaren Zugriff auf dieselben Projektdaten benötigt, die Ihr Team in GanttFather sieht. Der zuverlässigste erste Anwendungsfall ist eng gefasst – zum Beispiel die Erstellung eines Release-Meilensteins nach der Bereitstellung – und wird dann nach Beobachtung echter Fehler und Wiederholungsversuche erweitert.
API entscheidet nicht darüber, welches System ein Feld besitzt oder macht einen Multisystem-Workflow konfliktfrei. Ihre Integration muss diese Regeln definieren.
Erstellen Sie ein GanttFather-Projekt, stellen Sie ein Token mit den geringsten Rechten aus und testen Sie es mit verfügbaren Daten, bevor Sie Produktionsdatensätze verbinden.
Häufig gestellte Fragen
Ist der Zugriff auf API im kostenlosen Kontingent enthalten?
API-Zugriff ist derzeit für GanttFather-Pläne verfügbar. Es gelten weiterhin Kapazitäts- und Schutzgrenzen; Überprüfen Sie die Preisseite und API Quotendokumentation für die aktuellen Bedingungen.
Wie sieht ein GanttFather API-Token aus?
Token verwenden das GanttFather-Tokenformat und werden als Inhaberanmeldeinformationen dargestellt. Übergeben Sie niemals ein Token an die Quellcodeverwaltung und fügen Sie es niemals in ein öffentliches Protokoll ein.
Ist User-Agent optional?
Nein für normale v1-Anfragen. Senden Sie einen nicht leeren Wert, der Ihre Integration identifiziert, z. B. einen Produktnamen und eine Version.
Sollte jede Anfrage einen Idempotency-Key enthalten?
Nein. Verwenden Sie es für dokumentierte Erstellungsvorgänge, wenn dieselbe Anforderung möglicherweise wiederholt wird. Es handelt sich nicht um eine Allzweckversion oder einen Parallelitätsheader.
Können API Azure DevOps Integrationsquellen konfigurieren?
Die öffentlichen v1-Projektdaten API und die Produktintegration Azure DevOps sind separate Oberflächen. Gehen Sie nicht davon aus, dass ein undokumentierter Integrationsendpunkt vorhanden ist.
Wo ist die OpenAPI-Dokumentation?
Beginnen Sie mit dem GanttFather API Einführung und folgen Sie den Referenzlinks für Authentifizierung, Endpunkte, Schemata und Fehler.
