Web Services API – Übersicht & Erste Schritte
Die Web Services API von TripLog ermöglicht es Ihnen, TripLog-Daten direkt in Ihre eigenen Systeme zu integrieren. Nutzen Sie sie, um Fahrtdatensätze abzurufen, Benutzer zu verwalten, Spesendaten abzurufen und mehr – alles über standardmäßige HTTP-Anfragen und JSON.
Wer sie nutzen kann: Die API steht Abonnenten des Enterprise-Plans zur Verfügung. Der API-Zugriff wird auf Organisationsebene von einem Primary-Administrator verwaltet.
Basis-URL
Alle API-Anfragen werden gerichtet an:
https://app.triplog.net/web/api/
Authentifizierung
Jede Anfrage muss den API-Schlüssel Ihrer Organisation im Authorization-Header enthalten:
Authorization: apikey YOUR_API_KEY
Informationen zum Generieren oder Abrufen Ihres API-Schlüssels finden Sie unter So generieren Sie den API-Schlüssel.
Halten Sie Ihren API-Schlüssel sicher. Er gewährt vollständigen Lese-/Schreibzugriff auf die Daten Ihrer Organisation. Legen Sie ihn nicht in clientseitigem Code oder öffentlichen Repositories offen.
Anfrageformat
Protokoll: Nur HTTPS
Methode: GET oder POST, je nach Endpunkt (in jedem Artikel angegeben)
Content-Type:
application/jsonfür POST-Anfragen mit einem AnfragetextAntwortformat: JSON
Antwortgröße
Endpunkte, die Listen zurückgeben (wie /trips und /users), liefern alle passenden Datensätze in einer einzigen Antwort – es gibt keine Paginierung. Bei Organisationen mit großen Datenmengen kann dies zu sehr großen Payloads führen.
Um die Antwortgröße überschaubar zu halten:
Verwenden Sie die verfügbaren Datumsbereichsparameter, um Ihre Abfrage einzugrenzen (z. B.
startDate/endDatebeim Trips-Endpunkt)Vermeiden Sie Abfragen ohne Filter, es sei denn, ein vollständiger Datenexport ist beabsichtigt
HTTP-Statuscodes
Code | Bedeutung |
| Erfolg |
| Ungültige Anfrage – überprüfen Sie Ihre Parameter |
| Nicht autorisiert – fehlender oder ungültiger API-Schlüssel |
| Verboten – Ihr Plan beinhaltet keinen API-Zugriff |
| Ressource nicht gefunden |
| Serverfehler – versuchen Sie es nach kurzer Verzögerung erneut |
Verfügbare Endpunkte
Endpunkt | Beschreibung |
Benutzer Ihrer Organisation auflisten und verwalten | |
Standort eines Benutzers in Echtzeit | |
Fahrtdatensätze abrufen, gefiltert nach Benutzer und Datum | |
GPS-Wegpunkte für eine bestimmte Fahrt abrufen | |
Verwaltung der Fahrtgenehmigung | |
Kilometerstand-Statistiken nach Benutzer oder Zeitraum | |
Verwaltung von Benutzerstandorten | |
Fahrzeugdatensätze für Ihre Organisation | |
Spesendatensätze | |
Verwaltung der Spesengenehmigung | |
Belegbilder und Metadaten | |
Benutzerdefinierte Tags für Fahrten und Spesen erstellen und verwalten | |
Auf das Prüfprotokoll für Genehmigungsdatensätze zugreifen | |
Zeiterfassungsdatensätze nach Benutzer und Datumsbereich | |
Kilometerstand aufgeschlüsselt nach US-Bundesstaat |