Kurse
Der Bereich Kurse ermöglicht den Zugriff auf Kurse deines Unternehmens.
Erforderliche Scopes: courses + users (immer). Für die Teilnehmerliste (attendees) zusätzlich customers.
Benötigte Lizenz
Die Kurs-Endpoints setzen die Kurs-Lizenz des Unternehmens voraus.
Hinweis zu Teilnehmern: Ohne den Scope
customersfehlt der Schlüsselattendeesin der Antwort vollständig – er ist nicht[]und nichtnull. Die ZahlcurrentAttendeesbleibt immer enthalten.
Hinweis: Für Kurse gibt es keinen inkrementellen Abgleich. Ein Kurs führt keine Zeitstempel, es gibt also kein
createdSinceund keinupdatedSince.
Hinweis: Fehlt die Kurs-Lizenz, antworten beide Endpoints mit
403statt mit einer leeren Liste – ein403bedeutet hier nicht zwingend einen falschen Scope, sondern dass das Unternehmen keine Kurse führt.
Die Einrichtung eines API-Zugangs ist im Help Center beschrieben.
Endpoints
| Method | Endpoint | Beschreibung |
|---|---|---|
GET | /api/oauth/v2/resource/courses | Paginierte Liste aller Kurse |
GET | /api/oauth/v2/resource/courses/{uuid} | Details eines einzelnen Kurses |
GET | /api/oauth/v2/resource/courses/{uuid}/attendees | Paginierte Liste der Teilnahmen eines Kurses |
GET | /api/oauth/v2/resource/courses/{uuid}/attendees/{attendeeUuid} | Details einer einzelnen Kursteilnahme |