Offene Schnittstelle
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.
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/
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.
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.
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.

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.

FAQ
Häufig gestellte Fragen
Noch Fragen?
Buchen Sie sich einen Termin mit unserem Team.
Welche Daten liefert die REST-API?
Welche Daten liefert die REST-API?
Kann die REST-API Projekte anlegen und ändern?
Kann die REST-API Projekte anlegen und ändern?
Für wen ist die REST-API gedacht?
Für wen ist die REST-API gedacht?
Wie bekomme ich Zugang zur REST-API?
Wie bekomme ich Zugang zur REST-API?
Wie authentifiziert sich eine Anbindung, und was darf ein Schlüssel?
Wie authentifiziert sich eine Anbindung, und was darf ein Schlüssel?
Ist die Schnittstelle versioniert?
Ist die Schnittstelle versioniert?
Können wir mit unseren eigenen Kennungen arbeiten?
Können wir mit unseren eigenen Kennungen arbeiten?
Was passiert, wenn einzelne Datensätze nicht verarbeitet werden können?
Was passiert, wenn einzelne Datensätze nicht verarbeitet werden können?
Lassen sich Abwesenheiten ohne Personenbezug übertragen?
Lassen sich Abwesenheiten ohne Personenbezug übertragen?
Wie kommen große Datenmengen über die Schnittstelle?
Wie kommen große Datenmengen über die Schnittstelle?
Weitere Integrationen
Mehr erfahren
Linetrack im Detail
Die Module, deren Daten Ihre Systeme über die REST-API lesen und schreiben:
