Schnittstellen und API für die Zeiterfassung
Nutzen Sie die Web API von time cockpit, um Daten über HTTP, REST und JSON mit Ihren Systemen auszutauschen und Abläufe zu automatisieren.
30 Tage kostenlos · ohne Kreditkarte · danach täglich kündbar
Die Web API von time cockpit stellt jede Entität der Zeiterfassung über REST und OData bereit, dazu einen Query-Endpunkt für TCQL sowie Endpunkte für Listen, Aktionen und Berichte. Authentifiziert wird mit Personal Access Tokens. Power BI und Excel greifen direkt auf den OData-Endpunkt zu, der Excel-Importer holt bestehende Daten in time cockpit.
Web API für die Zeiterfassung: REST, OData und Query-Endpunkte
Mit der Web API von time cockpit binden Sie Ihre Projektzeiterfassung an bestehende Systeme an, verwalten Daten effizient und automatisieren Abläufe. Dank ihrer REST-basierten Architektur passt sie sich flexibel an Ihre Anforderungen an.
Zugriff auf Daten und Integration in bestehende Systeme
Mit der Web API greifen Sie umfassend auf die Daten in time cockpit zu, auch auf eigene Felder und Tabellen aus Ihren Anpassungen. Der OData-Endpunkt erlaubt CRUD-Operationen (Create, Read, Update, Delete). Dadurch nutzen Sie Werkzeuge wie Microsoft Power BI oder Excel, um interaktive Berichte zu erstellen, Daten zu analysieren oder für weitere Zwecke zu exportieren.
Für komplexere Anforderungen fragen Sie über den Query-Endpunkt beliebige Daten mit der time cockpit Query Language (TCQL) ab. Das eignet sich für Szenarien, in denen Sie Daten in externe Systeme übertragen oder detaillierte Analysen durchführen.
Drei weitere Endpunkte ergänzen OData und Query:
- ExecuteList liefert Listen, die Sie in time cockpit definieren und die wie eine Datenbankansicht funktionieren, etwa für projektspezifische Berichte oder Auswertungen im Projektcontrolling.
- ExecuteAction führt Aktionen mit Ihrer eigenen Geschäftslogik in IronPython aus, die in Ihrem time cockpit hinterlegt ist.
- Reporting erzeugt Ihre SSRS-Berichte auf Anfrage als PDF-, Word- oder Excel-Datei.
Web API und Integrationen von time cockpit auf einen Blick
- OData (lesen und schreiben)
- Query (TCQL), ExecuteList und ExecuteAction
- Reporting
- Authentifizierung per Personal Access Token
- Preis
- 10,85 € pro Benutzer und Monat
- Testphase
- 30 Tage kostenlos, ohne Kreditkarte
- Betrieb
- Microsoft Azure, Rechenzentren in der EU
- Single Sign-on
- Microsoft Entra ID
Schnittstellen für eine integrierte Zeiterfassung
Ihre erste OData-Anfrage
Jede Entität in time cockpit ist über den OData-Endpunkt erreichbar. Sie authentifizieren sich mit einem Personal Access Token und filtern, wählen und blättern dann genau die Daten, die Sie brauchen. Das Beispiel liefert zehn verrechenbare Zeitbuchungen. Power BI und Excel verbinden sich ohne eine Zeile Code mit demselben Endpunkt. Wie Entwicklerteams Zeiten buchen und Tickets über die API anlegen, zeigt die Seite Zeiterfassung für Entwickler.
GET /odata/APP_Timesheet()?$filter=APP_Billable eq true&$top=10 HTTP/1.1
Host: api.timecockpit.com
Authorization: Bearer <personal access token>
Accept: application/jsonSSO und Benutzerverwaltung per API
Mit Single Sign-on über Microsoft Entra ID (früher Azure Active Directory) melden sich Ihre Mitarbeitenden mit ihrem Firmenkonto an, und Ihre Sicherheitsrichtlinien gelten auch in time cockpit. Details dazu finden Sie unter Enterprise-Zeiterfassung.
In Unternehmen mit vielen Mitarbeitenden wird die manuelle Verwaltung von Benutzerkonten schnell unpraktisch. Mit der User Management API werden Benutzerkonten automatisiert erstellt, aktualisiert oder deaktiviert. Das ist besonders nützlich, wenn ein HR-System die Mitarbeiterdaten führt: Onboarding und Offboarding laufen automatisch, Zugriffsrechte bleiben aktuell, und keine inaktiven Konten verbleiben im System.
Sicherheit und Berechtigungen
Die Authentifizierung an der Web API erfolgt über Personal Access Tokens (PAT), sodass nur autorisierte Benutzer auf sensible Daten zugreifen. Die API ist vollständig in das Berechtigungssystem von time cockpit eingebunden: Jede Anfrage sieht nur, was der Benutzer des Tokens sehen darf. Wie time cockpit betrieben und gesichert wird, beschreibt die Seite Sicherheit und Datenschutz.
KI-Assistenten anbinden: der MCP-Server
Für Claude, ChatGPT, Copilot, Cursor und andere KI-Werkzeuge gibt es neben der Web API den MCP-Server für KI-Assistenten. Er stellt dieselben fachlichen Funktionen nach dem Model Context Protocol bereit: Benutzer melden sich mit ihrem Microsoft-Entra-ID-Konto an, ihre time cockpit-Berechtigungen gelten, und Änderungen führt der Assistent erst nach Bestätigung aus. Systemintegrationen bleiben bei der Web API, Fragen in natürlicher Sprache gehen an den MCP-Server.
SQL ist Ihre Leidenschaft?
Wenn Sie Daten lieber auf traditionelle Weise abfragen möchten, kein Problem. Im Business-Paket erhalten Sie auf Anfrage an support@timecockpit.com einen read-only Datenbankzugriff. Auf diese Weise binden Sie time cockpit an Werkzeuge wie Power BI oder Tableau an und nutzen das volle Potenzial Ihrer Daten. Schließlich handelt es sich um Ihre Datenbank und Ihre Daten.
SELECT * FROM APP_Timesheet
INNER JOIN APP_UserDetail
ON Relation_APP_UserDetail = APP_UserDetailUuidImportieren Sie Ihre Excel-Daten
Sie haben viele Ihrer Daten in Excel-Tabellen? Nutzen Sie den integrierten Excel-Importer von time cockpit. Ordnen Sie Ihre Excel-Arbeitsblätter den time cockpit-Tabellen zu, testen Sie den Import und laden Sie Ihre vorhandenen Daten in time cockpit.
Häufig gestellte Fragen
Hat time cockpit eine REST-API?
Ja. Die Web API ist eine REST-Schnittstelle mit JSON, über deren OData-Endpunkt Sie alle Entitäten der Zeiterfassung lesen und schreiben, auch eigene Felder und Tabellen.
Wie verbinde ich Power BI oder Excel mit der Zeiterfassung?
Power BI und Excel greifen über den OData-Endpunkt direkt auf die Daten in time cockpit zu, ganz ohne Programmierung. Wie Sie die Verbindung einrichten, beschreibt die OData-Dokumentation.
Was ist TCQL und wofür brauche ich den Query-Endpunkt?
TCQL (time cockpit Query Language) ist die Abfragesprache von time cockpit. Über den Query-Endpunkt fragen Sie damit genau die Daten ab, die Sie für Auswertungen oder die Übergabe an andere Systeme brauchen.
Wie authentifiziere ich mich an der time cockpit API?
Mit einem Personal Access Token, den Sie im Authorization-Header jeder Anfrage mitschicken. Jede Anfrage sieht nur die Daten, die der Benutzer des Tokens sehen darf.
Kostet die Web API extra?
Nein, die Web API mit Personal-Access-Token-Authentifizierung ist laut Preisseite in allen Paketen enthalten. Das automatische Anlegen und Entfernen von Benutzern per API sowie der direkte Lesezugriff auf die Datenbank sind dem Business-Paket vorbehalten.
Kann ich Benutzer automatisch per API anlegen und entfernen?
Ja, im Business-Paket legen Sie Benutzerkonten über die User Management API an, aktualisieren und deaktivieren sie. So übernehmen Sie Ein- und Austritte automatisch aus dem System, das Ihre Mitarbeiterdaten führt.
Kann ich bestehende Daten aus Excel importieren?
Ja, mit dem Excel-Importer ordnen Sie Ihre Arbeitsblätter den time cockpit-Tabellen zu, testen den Import und laden danach Ihre vorhandenen Daten.

