REST DokumentationMitarbeiterGET Projekte auflisten, denen ein Mitarbeiter zugeordnet ist

Projekte auflisten, denen ein Mitarbeiter zugeordnet ist

Liefert die paginierte Liste der Projektzuordnungen des angegebenen Mitarbeiters. Unterstützt Filterung nach project_status (string|array), project_start (YYYY-MM-DD) und project_end (YYYY-MM-DD).

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

Request

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

Pfad-Parameter

  • Name
    username
    Type
    string
    Description

    Der Benutzername des Mitarbeiters

Query-Parameter

  • Name
    perPage
    Type
    integer, nullable
    Description

    Wird auf diesem Endpunkt ignoriert — senden Sie stattdessen limit. Ein hier angegebener Wert wird durch limit ersetzt, oder durch den Standardwert, wenn limit fehlt.

  • Name
    page
    Type
    integer, nullable
    Description

    Die zurückzugebende Ergebnisseite, beginnend bei 1.

  • Name
    orderBy
    Type
    string, nullable
    Description

    Name des Feldes, nach dem sortiert wird.

  • Name
    order
    Type
    string, nullable
    Description

    Sortierrichtung, aufsteigend oder absteigend.

    Einer der Werte: "asc", "desc"

  • Name
    limit
    Type
    integer, nullable
    Description

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

  • Name
    project_status
    Type
    string, nullable
    Description

    Beschränkt das Ergebnis auf Projekte in einem oder mehreren Status. Sowohl ein einzelner Wert als auch eine Liste wird akzeptiert.

  • Name
    project_start_date
    Type
    string (date)
    Description

    Nur Projekte zurückgeben, deren Startdatum dieses Datum oder später ist.

  • Name
    project_end_date
    Type
    string (date)
    Description

    Nur Projekte zurückgeben, deren Enddatum an oder vor diesem Datum liegt. Darf nicht vor project_start_date liegen.

Response

{
  "data": [
    {
      "id": 1,
      "employee_id": "max.mustermann",
      "project_id": 16,
      "project_number": "P-1001",
      "from": "2025-01-01T00:00:00.000000Z",
      "to": "2025-12-31T00:00:00.000000Z",
      "note": "Familienurlaub",
      "availability": 100,
      "internal_rate": 1.5,
      "rate_type": {
        "id": 1,
        "name": "Hourly"
      },
      "type": {
        "id": 0,
        "name": "Project member"
      },
      "priceGroup": {
        "id": 1,
        "name": "EU",
        "number": "EU-1",
        "status": true,
        "description": {
          "de": "Preisgruppe EU",
          "en": "EU price group"
        }
      }
    }
  ],
  "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

    Die eindeutige Kennung der Zuordnung.

  • Name
    employee_id
    Type
    string
    Description

    Die Kennung des zugeordneten Mitarbeiters.

  • Name
    project_id
    Type
    integer
    Description

    Die Kennung des Projekts, zu dem die Zuordnung gehört.

  • Name
    project_number
    Type
    string, nullable
    Description

    Die Nummer des Projekts, zu dem die Zuordnung gehört; null, wenn das Projekt nicht mehr existiert.

  • Name
    from
    Type
    string (date-time), nullable
    Description

    Das Datum, ab dem die Zuordnung gilt.

  • Name
    to
    Type
    string (date-time), nullable
    Description

    Das Datum, bis zu dem die Zuordnung gilt.

  • Name
    note
    Type
    string, nullable
    Description

    Eine freie Notiz zur Zuordnung.

  • Name
    availability
    Type
    integer, nullable
    Description

    Wie viel der Zeit des Mitarbeiters für dieses Projekt zur Verfügung steht.

  • Name
    internal_rate
    Type
    number, nullable
    Description

    Der interne Stundensatz, der für die Zeit des Mitarbeiters im Projekt gilt.

  • Name
    rate_type
    Type
    object, nullable
    Description

    Wie der interne Satz angewendet wird: pro Stunde, pro Tag oder als Pauschale.

  • Name
    rate_type.id
    Type
    integer
    Description

    Der gespeicherte Wert. Vergleichen Sie damit, nicht mit name.

  • Name
    rate_type.name
    Type
    string
    Description

    Die lesbare Bezeichnung in der Sprache der Instanz. Nicht auswerten.

    Einer der Werte: "Hourly", "Täglich", "keines"

  • Name
    type
    Type
    object, nullable
    Description

    Die Position des Mitarbeiters im Projekt, z. B. Leitung oder Mitglied.

  • Name
    type.id
    Type
    integer
    Description

    Der gespeicherte Wert. Vergleichen Sie damit, nicht mit name.

  • Name
    type.name
    Type
    string
    Description

    Die lesbare Bezeichnung in der Sprache der Instanz. Nicht auswerten.

    Einer der Werte: "Project member", "Project manager with budget responsibility", "Projektleiter"

  • Name
    priceGroup
    Type
    object (PriceGroup)
    Description

    Die Preisgruppe, mit der der Mitarbeiter in diesem Projekt abgerechnet wird.

  • Name
    priceGroup.id
    Type
    integer
    Description

    Die eindeutige Kennung der Preisgruppe.

  • Name
    priceGroup.name
    Type
    string
    Description

    Der Name der Preisgruppe, wie er bei der Zuordnung zu einem Kunden oder Projekt angezeigt wird.

  • Name
    priceGroup.number
    Type
    string, nullable
    Description

    Die Nummer der Preisgruppe, die zur externen Referenzierung verwendet wird.

  • Name
    priceGroup.status
    Type
    boolean
    Description

    Ob die Preisgruppe aktiv ist; die zugrunde liegende Spalte wird invertiert gespeichert, true bedeutet hier aktiv.

  • Name
    priceGroup.description
    Type
    object
    Description

    Die Beschreibung der Preisgruppe, ausgegeben als sprachabhängige Struktur (i18n) statt als einfache Zeichenkette.

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