REST DokumentationProjekteGET Einem Vorgang zugewiesene Mitarbeiter auflisten

Einem Vorgang zugewiesene Mitarbeiter auflisten

Liefert eine paginierte Liste der dem angegebenen Vorgang zugewiesenen Mitarbeiter inklusive ihrer Preisgruppe. Die Liste ist absichtlich leer, wenn all_project_employees des Vorgangs true ist: Dann dürfen alle Projektmitarbeitenden auf den Vorgang buchen, daher ist kein Mitarbeiter explizit zugewiesen.

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

Request

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

Pfad-Parameter

  • Name
    id
    Type
    integer
    Description

    Die ID des Projekts

  • Name
    task_id
    Type
    integer
    Description

    Die ID des Vorgangs

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
    employee_id[]
    Type
    Liste von string
    Description
  • Name
    from
    Type
    string (date-time), nullable
    Description
  • Name
    to
    Type
    string (date-time), nullable
    Description
  • Name
    price_group[]
    Type
    Liste von string
    Description

Response

{
  "data": [
    {
      "id": 1,
      "project_id": 16,
      "project_task_id": 1,
      "employee_id": "max.mustermann",
      "from": "2026-01-01",
      "to": "2026-01-31",
      "note": "Familienurlaub",
      "price_group": {
        "id": 1,
        "name": "EU",
        "number": "string",
        "status": true,
        "description": {
          "de": "string",
          "en": "string",
          "fr": "string",
          "es": "string",
          "pl": "string"
        }
      }
    }
  ],
  "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 der Zuordnung.

  • Name
    project_id
    Type
    integer
    Description

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

  • Name
    project_task_id
    Type
    integer
    Description

    Kennung des Vorgangs, dem der Mitarbeiter zugeordnet ist.

  • Name
    employee_id
    Type
    string
    Description

    Kennung des zugeordneten Mitarbeiters.

  • Name
    from
    Type
    string (date), nullable
    Description

    Datum, an dem die Zuordnung beginnt.

  • Name
    to
    Type
    string (date), nullable
    Description

    Datum, an dem die Zuordnung endet.

  • Name
    note
    Type
    string, nullable
    Description

    Freitext-Notiz zur Zuordnung.

  • Name
    price_group
    Type
    object (PriceGroup), nullable
    Description

    Preisgruppe, mit der der Mitarbeiter in diesem Vorgang abgerechnet wird, sofern eine zugeordnet ist.

  • Name
    price_group.id
    Type
    integer
    Description

    Die eindeutige Kennung der Preisgruppe.

  • Name
    price_group.name
    Type
    string
    Description

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

  • Name
    price_group.number
    Type
    string, nullable
    Description

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

  • Name
    price_group.status
    Type
    boolean
    Description

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

  • Name
    price_group.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.