Web API

Time cockpit bietet eine webbasierte API. Über HTTP, REST und JSON können Sie Informationen abrufen und ändern, Geschäftslogik ausführen oder einen Bericht erzeugen, ohne von unserem .NET SDK abhängig zu sein. Dieser Dienst wird öffentlich gehostet, Kunden müssen keine zusätzlichen Installations- oder Konfigurationsschritte durchführen.

Die time cockpit API bietet verschiedene Endpunkte:

• OData-Endpunkt: Unterstützt gefilterte Abfragen, Metadaten-Reflection und Datenmanipulation (d. h. Einfügen, Ändern, Löschen)
• Query-Endpunkt: Unterstützt Abfragen von Daten in time cockpit mit der time cockpit Abfragesprache (TCQL).
• ExecuteList-Endpunkt: Führt time cockpit Listen aus. Listen zeigen Daten in der Benutzeroberfläche in Tabellenform an, ihre Daten können aber auch über die Web API abgerufen werden.
• ExecuteAction-Endpunkt: Führt time cockpit Aktionen aus. Eine Aktion ist eigene Geschäftslogik, die in Ihrem time cockpit Tenant gehostet wird.
• Reporting-Endpunkt: Führt einen time cockpit SSRS-Bericht aus.

Basisadresse

Die Basisadresse unserer Web API ist https://api.timecockpit.com. Sie ist nur über HTTPS erreichbar, und Sie müssen sich authentifizieren, bevor Sie die API verwenden können.

Authentifizierung

Derzeit werden drei Arten der Authentifizierung unterstützt:

• Token-Authentifizierung bietet eine einfache und effiziente Möglichkeit, Webanfragen zu authentifizieren. Ein Header überträgt das Zugriffstoken und identifiziert den Inhaber (Bearer).
• Basic-Authentifizierung mit Benutzername und Passwort wird von Werkzeugen verwendet, die keine Token-Authentifizierung anbieten (z. B. OData in Excel), sowie zum erstmaligen Abrufen von Authentifizierungstokens.
• PAT-Authentifizierung.

Warnung

Wir raten dringend von Token- oder Basic-Authentifizierung ab. Diese Authentifizierungsarten werden in absehbarer Zeit deaktiviert. Wir empfehlen dringend, sich mit PATs zu authentifizieren.

Wie Sie sich bei unserer Web API authentifizieren, lesen Sie unter Authentifizierung.