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.