Einem Vorgang zugewiesene Mitarbeiter auflisten

Liefert eine paginierte Liste der dem angegebenen Vorgang zugewiesenen Mitarbeiter inklusive ihrer Preisgruppe.

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": "string",
      "to": "string",
      "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, nullable
Description
Datum, an dem die Zuordnung beginnt.
Name
to
Type
string, 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.

DELETE Vorgang eines Projekts löschen GET Mitarbeiterzuordnung eines Vorgangs abrufen