Leistungszuordnungen abrufen

Gibt eine paginierte Liste aller aktiven Leistungszuordnungen zurück.

Request

GET /api/oauth/v2/resource/executions

Header

Header	Wert
Authorization	Bearer {access_token}

Query-Parameter

Parameter	Typ	Pflicht	Beschreibung
offset	integer	Nein	Startposition (Standard: 0)
limit	integer	Nein	Anzahl Ergebnisse (Standard: 50, Max: 200)
locationId	string (UUID)	Nein	Nur Zuordnungen eines bestimmten Standorts
userId	string (UUID)	Nein	Nur Zuordnungen eines bestimmten Mitarbeiters
view	string	Nein	default (Vorgabe) oder slim für die schlanke Payload

Erforderlicher Scope: executions

Response

Erfolg (200 OK)

{
  "data": [
    {
      "id": "42",
      "user": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "firstName": "Maria",
        "lastName": "Mustermann",
        "abbreviation": "MM"
      },
      "location": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
        "name": "Wien Mariahilfer"
      },
      "service": {
        "id": "c3d4e5f6-a7b8-9012-cdef-012345678901",
        "name": "Erstordination",
        "duration": 60,
        "price": 120.00
      }
    }
  ],
  "meta": {
    "total": 5,
    "offset": 0,
    "limit": 50
  }
}

Response-Felder

Feld	Typ	Beschreibung
data	Array	Liste der Leistungszuordnungen
data[].id	string	Eindeutige ID der Leistungszuordnung (ganzzahlig, kein UUID)
data[].user	object	Zugeordneter Mitarbeiter
data[].user.id	string (UUID)	Eindeutige ID des Mitarbeiters
data[].user.firstName	string	Vorname des Mitarbeiters
data[].user.lastName	string	Nachname des Mitarbeiters
data[].user.abbreviation	string	Kürzel des Mitarbeiters
data[].location	object	Zugeordneter Standort
data[].location.id	string (UUID)	Eindeutige ID des Standorts
data[].location.name	string	Name des Standorts
data[].service	object	Zugeordnete Leistung
data[].service.id	string (UUID)	Eindeutige ID der Leistung
data[].service.name	string	Name der Leistung
data[].service.duration	integer	Termindauer in Minuten
data[].service.price	number | null	Preis (brutto)
meta.total	integer	Gesamtanzahl der Leistungszuordnungen
meta.offset	integer	Aktuelle Startposition
meta.limit	integer	Anzahl der zurückgegebenen Ergebnisse

Hinweis: data[].id ist eine ganzzahlige ID als String – kein UUID wie bei anderen Endpoints.

Schlanker Abruf (?view=slim)

Mit ?view=slim liefert der Endpoint nur die wichtigsten Felder pro Leistungszuordnung. Ohne den Parameter bleibt der Abruf unverändert – bestehende Integrationen müssen nichts anpassen.

Wird view mehrfach angegeben, gilt die letzte Angabe – ?view=default&view=slim liefert also die schlanke Antwort.

Im schlanken Abruf schrumpfen user, location und service von vollständigen Objekten auf je ein Objekt mit nur id. Die Feldzahl bleibt bei 4, aber die Schlüsselzahl sinkt von 14 auf 4 pro Datensatz.

{
  "data": [
    {
      "id": "42",
      "user": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      },
      "location": {
        "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
      },
      "service": {
        "id": "c3d4e5f6-a7b8-9012-cdef-012345678901"
      }
    }
  ],
  "meta": {
    "total": 5,
    "offset": 0,
    "limit": 50
  }
}

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/executions?offset=0&limit=50&locationId=b2c3d4e5-f6a7-8901-bcde-f01234567890&userId=b2c3d4e5-f6a7-8901-bcde-f01234567890&view=default" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

offset integer

limit integer

locationId string

userId string

view string

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
400	invalid_request	Ungültige locationId oder userId
400	validation_error	Ungültiger Wert für view
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope executions nicht vorhanden
404	not_found	Standort oder Mitarbeiter nicht gefunden