Zum Inhalt springen
Developer

Trainer substitution

Event / Trainervertretung

Veranstaltungen12 EndpunkteEvent / Trainer substitution

Zusammenfassung für das Startseiten-Widget und das Menü-Badge: wie viele offene Termine die Person übernehmen darf, die nächsten davon sowie die eigenen bevorstehenden Vertretungen.

GET/api/event/trainer_substitution/summary

Query-Parameter

limitintegerEinträge pro Liste (Standard 3)

Antworten

200enabled, in_pool, available_count, available (erste Einträge), mine_upcoming_count, mine_upcoming (erste Einträge)

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/event/trainer_substitution/summary \
  --header 'x-iw-jwt-token: <TOKEN>'

Offene Termine, die der angemeldete Trainer jetzt übernehmen darf, nach Beginn sortiert.

GET/api/event/trainer_substitution/available

Query-Parameter

fromstring (date)
tostring (date)
eventinteger

Antworten

200Liste der Vertretungen, die die Person übernehmen darf

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/event/trainer_substitution/available \
  --header 'x-iw-jwt-token: <TOKEN>'

Angefragt und vom angemeldeten Trainer übernommen.

GET/api/event/trainer_substitution/mine

Query-Parameter

pastbooleantrue = vergangene, neueste zuerst

Antworten

200Eigene Vertretungen

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/event/trainer_substitution/mine \
  --header 'x-iw-jwt-token: <TOKEN>'

Mehrere Termine auf einmal übernehmen (z. B. alle offenen Termine eines Kurses). Jeder wird einzeln übernommen; das Ergebnis listet pro ID den Erfolg oder die Gründe auf.

POST/api/event/trainer_substitution/claim_multiple

Request-Body application/json

  • idsarray<integer>

Antworten

200Je ID: ok, state, reasons

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/event/trainer_substitution/claim_multiple \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '{"ids":[1]}'

Eigene Termine, die der angemeldete Trainer freigegeben hat und die noch gesucht werden.

GET/api/event/trainer_substitution/released

Antworten

200Eigene offene Freigaben

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/event/trainer_substitution/released \
  --header 'x-iw-jwt-token: <TOKEN>'

Ob der angemeldete Trainer diesen eigenen Termin für eine Vertretung freigeben darf („ich kann nicht“) oder eine frühere Freigabe zurücknehmen darf.

GET/api/event/trainer_substitution/release_check/{bookingId}

Pfad-Parameter

bookingIdPflichtstring

Antworten

200allowed, reasons, slot, deadline_hours und die eigene offene Freigabe (Vertretung), falls vorhanden

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/event/trainer_substitution/release_check/42 \
  --header 'x-iw-jwt-token: <TOKEN>'

Einen eigenen Termin für eine Vertretung freigeben: der Trainer wird daraus entfernt und der Termin den anderen Trainern angeboten. Nur für Veranstaltungstypen, die dies erlauben.

POST/api/event/trainer_substitution/release/{bookingId}

Pfad-Parameter

bookingIdPflichtstring

Request-Body application/json

  • notestring

Antworten

200Die eröffnete Vertretung

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/event/trainer_substitution/release/42 \
  --header 'content-type: application/json' \
  --header 'x-iw-jwt-token: <TOKEN>' \
  --data '{"note":"string"}'

Liefert einen einzelnen Eintrag zur Trainervertretung bei Veranstaltungen.

GET/api/event/trainer_substitution/{id}

Pfad-Parameter

idPflichtstring

Antworten

200Eine Vertretung mit can_claim / reasons für den angemeldeten Trainer

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/event/trainer_substitution/42 \
  --header 'x-iw-jwt-token: <TOKEN>'

Ob der angemeldete Trainer die Vertretung übernehmen darf und warum nicht. Ändert nichts.

POST/api/event/trainer_substitution/{id}/test

Pfad-Parameter

idPflichtstring

Antworten

200eligible und Begründungscodes

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/event/trainer_substitution/42/test \
  --header 'x-iw-jwt-token: <TOKEN>'

Den Termin übernehmen (DIRECT) oder das Büro darum bitten (APPROVAL). 400 mit Begründungs- codes, wenn die Person dies nicht darf, 409, wenn jemand anderes schneller war.

POST/api/event/trainer_substitution/{id}/claim

Pfad-Parameter

idPflichtstring

Query-Parameter

lock_versionintegerlock_version der angezeigten Vertretung

Antworten

200Die Vertretung nach der Übernahme

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/event/trainer_substitution/42/claim \
  --header 'x-iw-jwt-token: <TOKEN>'

Eine eigene Freigabe zurücknehmen, solange niemand den Termin angefragt oder übernommen hat.

POST/api/event/trainer_substitution/{id}/take_back

Pfad-Parameter

idPflichtstring

Query-Parameter

lock_versioninteger

Antworten

200Die abgeschlossene Vertretung

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/event/trainer_substitution/42/take_back \
  --header 'x-iw-jwt-token: <TOKEN>'

Zurücktreten von einer Anfrage oder von einem übernommenen Termin vor der Frist.

POST/api/event/trainer_substitution/{id}/withdraw

Pfad-Parameter

idPflichtstring

Query-Parameter

lock_versioninteger

Antworten

200Die Vertretung nach dem Zurücktreten

Anfrage
curl --request POST \
  --url https://eure-instanz.iw-erp.de/api/event/trainer_substitution/42/withdraw \
  --header 'x-iw-jwt-token: <TOKEN>'