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.

Docs

Gängige Rezepte

Rezept 1: Benutzer aus HRM synchronisieren

Ein gängiges Integrationsmuster ist die Synchronisierung von Benutzern aus einem HRM-System mit Pluvo. Verwenden Sie createUser mit einer Referenz, die der HRM-Mitarbeiter-ID entspricht, und updateUser, um die Daten aktuell zu halten.

mutation {
  createUser(user: {
    email: "employee@company.com"
    name: "Jane Doe"
    ref: "HRM-12345"
    sendMail: false
  }) {
    user { id ref }
  }
}

Rezept 2: Massenanmeldung

Melden Sie alle Mitglieder einer Gruppe für eine Veranstaltung an:

mutation {
  createOfferEventEnrollments(
    offerEventId: "uuid"
    groupId: "group-uuid"
    sendMail: false
  ) {
    id user { name }
  }
}

Rezept 3: Fortschrittsberichte

Exportieren Sie den Trainingsfortschritt aller Benutzer, um ihn mit externen Systemen zu synchronisieren.