Developer docs
De Pluvo API geeft je programmatische toegang tot je leeromgeving. Beheer gebruikers, groepen, trainingen, inschrijvingen en certificaten vanuit je eigen systemen.
De API is gebaseerd op GraphQL. Je bepaalt zelf welke data je opvraagt of muteert, zonder overbodige velden. Authenticatie verloopt via OAuth 2.0 met client credentials. Webhooks houden je systemen real-time op de hoogte van wijzigingen.
Konzept & Architektur
Strukturübersicht
Willkommen in der API-Dokumentation von Pluvo. Die API folgt einer klaren hierarchischen Struktur.
Kernentitäten
- Organisation: Übergeordneter Container (Ihre Akademie)
- Benutzer: Personen in Ihrer Organisation
- Gruppen: Sammlungen von Benutzern
- Training: Kursinhalte mit Modulen und Kapiteln
- Angebot: Anmelde-Wrapper für Trainings
- Angebotsereignis: Konkrete Instanz mit Terminen und Kapazität
- Anmeldung: Registrierung eines Benutzers für ein Ereignis
- Portfolio: Fortschritt und Leistungen des Benutzers
Beziehungen
Organisation → Benutzer → Gruppen. Training → Angebot → Angebotsereignis → Anmeldung. Benutzer erwerben Portfolio-Elemente durch die Teilnahme an Trainings.