REST DokumentationMitarbeiterGET Anfahrtsdaten eines Mitarbeiters auflisten

Anfahrtsdaten eines Mitarbeiters auflisten

Liefert die Anfahrtsdaten-Einträge des Mitarbeiters, der älteste valid_from zuerst. Erfordert das Modul Inovex.

Verfügbarkeit: Nur Vollversion — eine Clock-Instanz antwortet auf diesen Endpunkt mit 404.

Request

GET /api/v1/employees/{username}/travel-data
curl --request GET \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/employees/{username}/travel-data' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Pfad-Parameter

  • Name
    username
    Type
    string
    Description

    Der Benutzername des Mitarbeiters

Query-Parameter

  • Name
    limit
    Type
    integer, nullable
    Description

    Die Anzahl der Datensätze pro Seite, 1 bis 200. Standardwert ist 15.

  • Name
    page
    Type
    integer, nullable
    Description

    Die zurückzugebende Ergebnisseite, beginnend bei 1.

Response

{
  "data": [
    {
      "id": 1,
      "username": "max.mustermann",
      "valid_from": "2026-01-01",
      "distance": 1.5,
      "travel_time": 1.5
    }
  ],
  "links": {
    "first": "string",
    "last": "string",
    "prev": "string",
    "next": "string"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": "string",
        "label": "string",
        "active": true
      }
    ],
    "path": "string",
    "per_page": 1,
    "to": 1,
    "total": 1
  }
}

Response-Felder

  • Name
    id
    Type
    integer
    Description

    Eindeutige Kennung des Anfahrtsdaten-Eintrags.

  • Name
    username
    Type
    string
    Description

    Benutzername des Mitarbeiters, zu dem der Eintrag gehört.

  • Name
    valid_from
    Type
    string (date)
    Description

    Erster Kalendertag, ab dem Entfernung und Anfahrtzeit gelten, als Y-m-d.

  • Name
    distance
    Type
    number
    Description

    Entfernung zum Arbeitsort in Kilometern.

  • Name
    travel_time
    Type
    number
    Description

    Anfahrtzeit zum Arbeitsort in Stunden.

Aus der OpenAPI-Spezifikation erzeugt — Änderungen gehören in den Quellcode, nicht auf diese Seite.