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.
Anmeldungen
Use Cases
Anmeldungen in Pluvo werden über ein OfferEvent abgewickelt. Ein Benutzer meldet sich nicht direkt für eine Schulung an, sondern für einen bestimmten Einstiegszeitpunkt innerhalb eines Angebots.
Benutzer für ein Event anmelden (Massenverarbeitung)
mutation {
createOfferEventEnrollments(
offerEventId: "uuid-event"
userIds: ["uuid-user-1", "uuid-user-2"]
sendMail: false
sendNotification: true
) {
id
user { id name email }
status
}
}Anmeldestatus aktualisieren
mutation {
updateOfferEventEnrollments(
offerEventEnrollmentIds: ["enrollment-uuid-1"]
status: APPROVED
sendMail: true
) {
id
status
user { name }
}
}Anmeldungen löschen
mutation {
deleteOfferEventEnrollments(
offerEventEnrollmentIds: ["enrollment-uuid-1"]
) {
ok
}
}Notes
- Verwenden Sie createOfferEventEnrollments für die programmgesteuerte Anmeldung – unterstützt sowohl ID als auch Ref.
- sendMail: false wird für Massenvorgänge empfohlen.
- Anmelde-Webhooks werden automatisch ausgelöst, wenn sich Anmeldungen ändern.