REST DokumentationProjekteGET Vorgänge eines Projekts auflisten

Vorgänge eines Projekts auflisten

Liefert eine paginierte Liste der Vorgänge des angegebenen Projekts.

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

Request

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

Pfad-Parameter

  • Name
    id
    Type
    integer
    Description

    Die ID des Projekts

Query-Parameter

  • Name
    perPage
    Type
    integer, nullable
    Description

    Die Anzahl der Datensätze pro Seite.

    Einer der Werte: 5, 10, 15

  • 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
    start_date
    Type
    string (date)
    Description
  • Name
    end_date
    Type
    string (date)
    Description
  • Name
    project_id
    Type
    integer, nullable
    Description
  • Name
    project_status_id
    Type
    string, nullable
    Description
  • Name
    project_start_date
    Type
    string (date-time)
    Description
  • Name
    project_end_date
    Type
    string (date-time)
    Description
  • Name
    project_department_id
    Type
    integer, nullable
    Description
  • Name
    modified_after
    Type
    string (date-time)
    Description

    Nur Datensätze zurückgeben, die nach diesem Zeitstempel geändert wurden (ISO 8601 oder “Y-m-d H:i:s”).

  • Name
    modified_before
    Type
    string (date-time)
    Description

    Nur Datensätze zurückgeben, die vor oder zu diesem Zeitstempel geändert wurden (ISO 8601 oder “Y-m-d H:i:s”).

  • Name
    search
    Type
    string, nullable
    Description

Response

{
  "data": [
    {
      "id": 1,
      "name": "EU",
      "status": "string",
      "description": "Angebot|en:offer",
      "parent_id": 1,
      "start_date": "2024-01-15T00:00:00.000000Z",
      "end_date": "2024-01-16T00:00:00.000000Z",
      "billing_type": {
        "id": 1,
        "name": "Like project"
      },
      "project_id": 16,
      "created": "2024-07-20T11:30:00.000000Z",
      "modified": "2024-07-20T12:30:00.000000Z",
      "plan_hours_children": 1.5,
      "plan_hours_done": 1.5,
      "plan_wage": 1.5,
      "plan_hours": 1.5,
      "plan_wage_children": 0,
      "plan_hours_invoiced": 1.5,
      "order_number": "string",
      "tickets_import_mailbox_name": "string",
      "dynamicAttributes": [
        {
          "name": "EU",
          "value": "Max Mustermann (Bruder)",
          "type": "Text",
          "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 des Vorgangs.

  • Name
    name
    Type
    string
    Description

    Name des Vorgangs.

  • Name
    status
    Type
    string, nullable
    Description

    Kennung des aktuellen Status des Vorgangs, sofern der Status ermittelt werden konnte.

  • Name
    description
    Type
    string, nullable
    Description

    Freitext-Beschreibung des Vorgangs.

  • Name
    parent_id
    Type
    integer, nullable
    Description

    Kennung des übergeordneten Vorgangs, bei einem Vorgang, der unter einem anderen eingeordnet ist.

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

    Datum, an dem der Vorgang beginnt.

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

    Datum, an dem der Vorgang endet.

  • Name
    billing_type
    Type
    object, nullable
    Description

    Wie der Vorgang abgerechnet wird: Stundensatz, Tagessatz, Pauschale oder wie das Projekt.

  • Name
    billing_type.id
    Type
    integer
    Description

    Der gespeicherte Wert. Vergleichen Sie gegen diesen, nicht gegen name.

  • Name
    billing_type.name
    Type
    string
    Description

    Die lesbare Bezeichnung in der Sprache des Mandanten. Nicht parsen.

    Einer der Werte: "Like project", "Stundensatz", "Tagessatz", "Pausch"

  • Name
    project_id
    Type
    integer
    Description

    Kennung des Projekts, zu dem dieser Vorgang gehört.

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

    Datum und Uhrzeit der Erstellung des Vorgangs.

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

    Datum und Uhrzeit der letzten Änderung des Vorgangs.

  • Name
    plan_hours_children
    Type
    number, nullable
    Description

    Geplante Stunden, die über die Teilaufgaben dieses Vorgangs budgetiert sind.

  • Name
    plan_hours_done
    Type
    number, nullable
    Description

    Bereits auf den Vorgang erfasste Stunden.

  • Name
    plan_wage
    Type
    number, nullable
    Description

    Geplante Gesamtlohnkosten, die für den Vorgang budgetiert sind.

  • Name
    plan_hours
    Type
    number, nullable
    Description

    Geplante Gesamtstunden, die für den Vorgang budgetiert sind.

  • Name
    plan_wage_children
    Type
    number, nullable
    Description

    Geplante Lohnkosten, die über die Teilaufgaben dieses Vorgangs budgetiert sind.

  • Name
    plan_hours_invoiced
    Type
    number, nullable
    Description

    Bereits für den Vorgang abgerechnete Stunden.

  • Name
    order_number
    Type
    string, nullable
    Description

    Fortlaufende Ordnungsnummer des Vorgangs, wird zur Sortierung verwendet.

  • Name
    tickets_import_mailbox_name
    Type
    string, nullable
    Description

    Name des Postfachs, aus dem Tickets in diesen Vorgang importiert werden.

  • Name
    dynamicAttributes
    Type
    Liste von DynamicAttribute
    Description

    Für den Vorgang konfigurierte dynamische Attribute.

  • Name
    dynamicAttributes.name
    Type
    string
    Description

    Name der Definition des dynamischen Attributs, für die dieser Wert eingegeben wurde.

  • Name
    dynamicAttributes.value
    Type
    any
    Description

    Der gespeicherte Wert; seine Form hängt vom benachbarten Feld type ab (eine Zeichenkette, eine Zahl, ein Boolean, ein Datum, eine Mitarbeiterreferenz oder eine Liste von Optionswerten).

  • Name
    dynamicAttributes.type
    Type
    string
    Description

    Datentyp dieses Attributs, z. B. Text, Zahl, Datum oder Optionen; bestimmt, wie value zu interpretieren ist.

    Einer der Werte: "Text", "Integer", "Float", "URL", "E-Mail", "Datum", "Uhrzeit", "Datetime", "Boolean", "Betrag", "Optionen", "Prozent", "Time period", "Textarea", "Users", "Upload"

  • Name
    dynamicAttributes.description
    Type
    object, nullable
    Description

    Erläuterung, was dieses Attribut erfasst, wie in seiner Definition konfiguriert.

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