Offene Schnittstelle

REST-API
für eigene Anbindungen

Über die REST-API legen Ihre Systeme Projekte samt Plan an, pflegen Vorgänge, Abhängigkeiten und Zuweisungen, gleichen Mitarbeiter und Abwesenheiten ab und lesen Kennzahlen aus – als offene Standardschnittstelle der Plattform, wahlweise angebunden durch Ihre IT oder durch Linetrack.
Linetrack Projektmanagement-Software mit offener REST-API für eigene Anbindungen

Kurzfassung

Die REST-API ist die offene Standardschnittstelle der Linetrack-Plattform. Sie liest und schreibt Projekte samt Plan, Vorgänge, Abhängigkeiten, Ressourcen-Zuweisungen, ToDos, offene Punkte, Mitarbeiter, Abwesenheiten, Vorlagen und Projektpartner und liefert Kennzahlen. Jeder API-Key darf nur, was ihm seine Scopes erlauben. Die REST-API ergänzt die fertigen Anbindungen an ERP, AIDA, MS Project, Excel und SAP dort, wo noch keine vorgefertigte Schnittstelle existiert.

Datenzugriff

Was die REST-API bereitstellt

Die REST-API ist die offene Standardschnittstelle der Linetrack-Plattform für eigene Anbindungen – lesend und schreibend.

  1. Bereitgestellte Daten: Projekte mit Plan, Vorgänge und Meilensteine, Abhängigkeiten, Zuweisungen, ToDos und offene Punkte, Mitarbeiter und Abwesenheiten, Vorlagen, Projektpartner und Kennzahlen.
  2. Art der Schnittstelle: Versionierte REST-Schnittstelle mit JSON, API-Key im Header und Berechtigungen je Bereich (Scopes).

Die vollständige Liste aller angebundenen Systeme steht auf der Integrationen-Übersicht.

Aufbau

Wie die Schnittstelle aufgebaut ist

Alle Endpunkte liegen unter einem versionierten Pfad, sprechen JSON und sind nach Bereichen gegliedert. Jeder Bereich hat einen Scope zum Lesen und, wo geschrieben wird, einen zum Schreiben. Listen kommen seitenweise, ein Objekt einer fremden Firma antwortet wie ein unbekanntes mit 404.

/api/integrations/v1/

Ihre SystemeERP und PPSZeiterfassung und HREigene AuswertungenREST-APIX-API-KEYLinetrackProjekte und PläneRessourcenVorlagen und PartnerSCHREIBEN · POST · PATCH · PUT · DELETELESEN · GETIhre SystemeERP und PPSZeiterfassung und HREigene AuswertungenSCHREIBENPOST · PATCH · PUT · DELETELESENGETREST-APIX-API-KEYLinetrackProjekte und PläneRessourcenVorlagen und Partner
/companies

Firma und Stammdaten

Der Einstieg jeder Anbindung: mit welchen Nutzern, Gruppen, Kalendern und Feldern dieser Mandant arbeitet.

Scope: company:read

  • GET Firmenprofil
  • GET Nutzer
  • GET Gruppen
  • GET Kalender
  • GET Benutzerdefinierte Felder
/projects

Projekte

Leer, aus einer Vorlage oder gleich mit dem ganzen Plan anlegen – und über Ihre eigene Kennung wiederfinden.

Scope: projects:read · projects:write

  • GET Projektliste und einzelnes Projekt
  • GET Projekt über Ihre eigene Kennung
  • GET Archivierte Projekte
  • GET Stundenbericht je Projekt
  • POST Projekt anlegen, auch mit Plan
  • PATCH Projektkopf ändern
  • DELETE Projekt löschen
…/ordersteps · …/links

Vorgänge und Abhängigkeiten

Der Plan als seitenweise Liste, jeder Vorgang einzeln pflegbar und die Abhängigkeiten wie im Gantt, in allen vier Arten.

Scope: projects:read · projects:write

  • GET Vorgänge, Meilensteine, Zuweisungen
  • POST Vorgang oder Meilenstein anlegen
  • PATCH Termine, Fortschritt, Status, Position
  • DELETE Vorgang löschen
  • GET Abhängigkeiten
  • POST Abhängigkeit anlegen
  • PATCH Art und Versatz ändern
  • DELETE Abhängigkeit löschen
…/people · …/assignments

Bearbeiter und Ressourcen

Wer an einem Vorgang arbeitet, wer das Ergebnis bekommt und welche Ressource mit wie vielen Stunden eingeplant ist – externe Personen eingeschlossen.

Scope: projects:write · resources:write

  • GET Bearbeiter und Empfänger
  • PUT Bearbeiter und Empfänger setzen
  • PUT Ressourcen-Zuweisungen in Stunden
…/todos · …/open-points

ToDos und offene Punkte

Die ToDos an einem Vorgang und die offenen Punkte eines Projekts – lesen, anlegen und abhaken aus dem Quellsystem.

Scope: projects:read · projects:write

  • GET ToDos eines Vorgangs
  • POST ToDo anlegen
  • PATCH ToDo umbenennen oder abhaken
  • GET Offene Punkte
  • POST Offenen Punkt anlegen
  • PATCH Offenen Punkt ändern oder abhaken
/resources

Ressourcen und Abwesenheiten

Der Teil, der am häufigsten läuft: Mitarbeiterstamm und Abwesenheiten kommen aus Personalsystem und Zeiterfassung.

Scope: resources:read · resources:write

  • GET Ressourcen der Firma
  • GET Auslastungen
  • GET Abwesenheiten im Zeitraum
  • PUT Mitarbeiter abgleichen
  • PUT Virtuelle Ressourcen abgleichen
  • PUT Abwesenheiten abgleichen
  • PUT Abwesenheiten ohne Personenbezug
/templates

Vorlagen

Vorlagen tragen Versätze in Arbeitstagen statt Terminen. Ein Projekt aus der Vorlage bekommt seine Termine vom Startdatum und Kalender.

Scope: templates:read · templates:write

  • GET Vorlagen und ihre Vorgänge
  • POST Vorlage mit Plan anlegen
  • PATCH Kopfdaten ändern
  • DELETE Vorlage löschen
/project-partners

Projektpartner

Lieferanten und Partnerfirmen mit ihren Kontakten, abgeglichen über Ihre Lieferantennummer, und ihre Zuordnung zu Projekten.

Scope: partners:read · partners:write

  • GET Projektpartner und Kontakte
  • POST Partner oder Kontakt anlegen
  • PATCH Partner oder Kontakt ändern
  • PUT Partner eines Projekts zuordnen
/kpis

Kennzahlen

Berechnet wie in Projektliste und KPI-Dashboard – für eigene Berichte, ohne die Werte selbst nachzurechnen.

Scope: kpis:read

  • GET Kennzahlen eines Projekts
  • GET Kennzahlen aller laufenden Projekte
  • GET Kapazität und Auslastung je Ressourcengruppe

Welche Endpunkte Ihre Anbindung braucht, hängt von der Richtung ab. Eine reine Auswertung kommt mit lesenden Scopes aus; ein Abgleich aus dem Personalsystem braucht nur resources:write. Jeden Endpunkt mit seinen Feldern beschreibt die API-Dokumentation in Linetrack.

Zugang

Ein Schlüssel je Anbindung, mit genau den Rechten, die sie braucht

Server-zu-Server-Anbindungen melden sich nicht als Person an. Sie tragen einen eigenen Schlüssel im Header, der auf genau einen Mandanten zeigt und nur darf, was seine Scopes erlauben.

Ein Header, mehr nicht

Jede Anfrage trägt den Schlüssel als X-API-KEY. Kein Anmeldevorgang, keine ablaufende Sitzung, kein Token-Tausch vor jedem Aufruf.

Scopes je Bereich

Lesen und Schreiben sind je Bereich getrennt, etwa projects:read oder resources:write. Ohne Auswahl bekommt ein Schlüssel nur lesende Scopes; das Ändern und Löschen von Vorlagen muss ausdrücklich vergeben werden.

Fest auf Ihren Mandanten gebunden

Der Schlüssel gehört zu Ihrer Firma und einem technischen Konto, das keine Nutzerlizenz verbraucht. Ein Objekt einer anderen Firma beantwortet die API wie ein unbekanntes – auch ihre Existenz verrät sie nicht.

Sperren, rotieren, Rechte ändern

Ein Administrator sperrt einen Schlüssel, tauscht ihn gegen einen neuen mit denselben Scopes oder ändert seine Scopes. Das wirkt ab dem nächsten Aufruf, ohne Neustart.

Nie im Klartext gespeichert

Hinterlegt wird nur ein Hash. Wer die Datenbank liest, bekommt den Schlüssel nicht zurück. Fehlgeschlagene Prüfungen werden je Absender gebremst.

Jeder Aufruf steht im Protokoll

Zeitpunkt, Konto, Methode, Pfad und Ergebnis werden mitgeschrieben. Wenn jemand fragt, woher ein Wert stammt, gibt es eine Antwort statt einer Vermutung.

In der Praxis

Ein Abgleich, wie er tatsächlich abläuft

Der häufigste Fall: Der Mitarbeiterstamm kommt aus dem Personalsystem. Sie liefern den ganzen Stand, Linetrack entscheidet je Satz, ob er neu ist oder aktualisiert wird.

01Ihr System liefertPUT /resources/users/bulkDer vollständige Stand,nicht die Differenz.02Linetrack gleicht abemployeeNoZuordnung über diePersonalnummer.03Sie bekommen AntwortNeu angelegt3Aktualisiert52Ohne Lizenz übersprungen0Freie Lizenzen danach601Ihr System liefertPUT /resources/users/bulkDer vollständige Stand, nicht dieDifferenz.02Linetrack gleicht abemployeeNoZuordnung über die Personalnummer.03Sie bekommen AntwortNeu angelegt3Aktualisiert52Ohne Lizenz übersprungen0Freie Lizenzen danach6
01

Der ganze Stand statt einer Differenz

Sie schicken alle Mitarbeiter, nicht die Änderungen seit dem letzten Lauf. Ein ausgefallener Lauf hat damit keine Folgen – der nächste bringt alles wieder in Deckung.

02

Die Personalnummer ist der Schlüssel

Zugeordnet wird über die Personalnummer aus Ihrem System. Ein Namenswechsel nach der Hochzeit ist damit eine Aktualisierung und kein zweiter Mitarbeiter.

03

Teilerfolg ist ein Ergebnis, kein Fehler

Sätze, die nicht verarbeitet werden konnten, kommen einzeln zurück – mit Kennung und Grund. Der Rest des Laufs bleibt davon unberührt.

04

Der Lizenzstand steht in der Antwort

Wie viele Nutzerlizenzen nach dem Lauf frei sind, steht mit in der Antwort. Ihr Job merkt es also selbst, wenn es eng wird.

Datenschutz

Abwesenheiten übertragen, ohne Namen zu übertragen

Abwesenheiten aus einer Zeiterfassung sind personenbezogen, sobald ein Name oder die Art der Abwesenheit daran hängt. In vielen Häusern scheitert genau daran die Anbindung – nicht an der Technik, sondern am Betriebsrat.

Für diesen Fall gibt es einen zweiten Weg für dieselben Daten: Statt Namen übergeben Sie eine Kennung, die Ihr System ohnehin führt – die interne Kennung der Ressource, ein Kürzel oder die Personalnummer – und nur Zeitraum und Umfang, nicht ob es Urlaub oder Krankheit war. Linetrack löst die Kennung im eigenen Bestand auf. Aus Ihrem System geht kein Name heraus.

Welche der drei Kennungen Sie verwenden, entscheiden Sie; die Schnittstelle nimmt alle drei entgegen.

Linetrack Auslastungsübersicht der Ressourcen über mehrere Abteilungen

Herausforderung

Warum nicht jede Anbindung als Standard existiert

Für AIDA, ERP-Systeme, MS Project, Excel und SAP sind die Anbindungen bereits entwickelt und laufen ohne Zusatzaufwand. Für ein firmenspezifisches System oder ein selbst gebautes Tool existiert dagegen keine vorgefertigte Schnittstelle.

Genau dafür stellt Linetrack eine offene REST-API bereit, über die sich Projekte, Vorgänge und Ressourcen nicht nur auslesen, sondern auch anlegen und pflegen lassen – etwa für eigene Auswertungen im Multiprojektmanagement.

Auch für ERP-Systeme, die noch nicht zu den fertigen Anbindungen zählen, lässt sich über die REST-API eine eigene Verbindung bauen – Details zu den bereits fertigen ERP-Anbindungen auf der Seite zur ERP-Integration.

Den API-Key legt ein Administrator Ihrer Firma selbst an und wählt dabei, was er darf. Welche Endpunkte Ihre Anbindung braucht, klären wir gern vorab im persönlichen Kontakt.

REST-API in Linetrack: verbundene Termin- und Kapazitätsplanung

FAQ

Häufig gestellte Fragen

Noch Fragen?

Buchen Sie sich einen Termin mit unserem Team.

Welche Daten liefert die REST-API?

Die REST-API liest und schreibt Projekte samt Plan, Vorgänge und Meilensteine, Abhängigkeiten, Bearbeiter und Empfänger, Ressourcen-Zuweisungen, ToDos und offene Punkte. Dazu kommen Mitarbeiter und Abwesenheiten, Vorlagen, Projektpartner mit Kontakten, Stammdaten der Firma und Kennzahlen. Vorgangsdaten entsprechen den Daten, wie sie auch im Taskmanagement geführt werden.

Kann die REST-API Projekte anlegen und ändern?

Ja. Ein Projekt lässt sich leer, aus einer Vorlage oder gleich mit seinem Plan anlegen: verschachtelte Vorgänge, Meilensteine und Abhängigkeiten. Der Plan steht damit von Anfang an im Soll-Plan. Danach lassen sich Projektkopf, Vorgänge, Abhängigkeiten und Zuweisungen einzeln ändern und Projekte, Vorgänge, Abhängigkeiten und Vorlagen auch löschen. Schreibzugriffe laufen durch dieselbe Logik wie die Oberfläche, mit Historie, Terminrechnung und Benachrichtigungen; als Autor steht der API-Nutzer drin.

Für wen ist die REST-API gedacht?

Für Systeme, für die es keine fertige Anbindung gibt. Die Verbindung kann wahlweise durch die IT des Kunden oder durch Linetrack gebaut werden.

Wie bekomme ich Zugang zur REST-API?

Ein Administrator Ihrer Firma legt den API-Key im Reiter „API-Keys“ der Unternehmens-Verwaltung an und wählt dabei die Berechtigungen. Im Hintergrund entsteht ein technischer Benutzer, der keine Nutzerlizenz verbraucht. Einen externen Dienstleister braucht er dafür nicht als Administrator einzurichten, er gibt ihm nur den Schlüssel weiter.

Wie authentifiziert sich eine Anbindung, und was darf ein Schlüssel?

Über einen API-Schlüssel im Header X-API-KEY. Jeder Schlüssel trägt Scopes, getrennt nach Bereich und nach Lesen oder Schreiben, zum Beispiel projects:read oder resources:write. Ein Aufruf außerhalb seiner Scopes wird mit 403 abgelehnt. Der Schlüssel gehört zu genau einem Mandanten, wird nur als Hash gespeichert und lässt sich jederzeit sperren oder rotieren.

Ist die Schnittstelle versioniert?

Ja. Alle Endpunkte liegen unter /api/integrations/v1/. Die Version ist ein eigener Vertrag, getrennt von der internen Schnittstelle der Oberfläche, und durch eigene Tests abgesichert. Neue Möglichkeiten kommen als neue Endpunkte, Felder und Scopes hinzu; ein bestehender Schlüssel bekommt einen neuen schreibenden Scope nicht automatisch.

Können wir mit unseren eigenen Kennungen arbeiten?

Ja. Projekte, Vorgänge und Projektpartner tragen eine externe Kennung aus Ihrem Quellsystem, je Firma eindeutig – bei Projektpartnern etwa die Lieferantennummer. Über diese Kennung lassen sich Projekte und Vorgänge lesen und ändern. Ihre Anbindung muss die internen Kennungen von Linetrack also nicht mitführen.

Was passiert, wenn einzelne Datensätze nicht verarbeitet werden können?

Beim Abgleich von Mitarbeitern bricht der Lauf nicht ab. Die Antwort weist getrennt aus, wie viele Einträge angelegt und wie viele aktualisiert wurden, und listet die nicht verarbeiteten Sätze einzeln mit Kennung und Grund auf. Beim nächsten Lauf werden sie erneut mitgeliefert. Abgelehnte Einzelaufrufe antworten als Problem Detail nach RFC 9457: Den Fall erkennt Ihr System am Status und am type, nicht am Fehlertext.

Lassen sich Abwesenheiten ohne Personenbezug übertragen?

Ja. Für Abwesenheiten und Auslastungen gibt es einen zweiten Weg, der statt Namen eine Kennung entgegennimmt – die interne Kennung der Ressource, ein Kürzel oder die Personalnummer – und keine Art der Abwesenheit. Die Zuordnung passiert in Linetrack, aus Ihrem System geht kein Name heraus.

Wie kommen große Datenmengen über die Schnittstelle?

Listen sind seitenweise abrufbar, mit bis zu 500 Einträgen je Seite und der Gesamtzahl in jeder Antwort. Ein Projekt lässt sich mit bis zu 2000 Vorgängen, 20 Ebenen und 5000 Abhängigkeiten in einem Aufruf anlegen.