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

ExtraCategory

Anwendung und Struktur

Eine ExtraCategory ist ein benutzerdefiniertes Feld, das Benutzern, Gruppen, Schulungen oder Angeboten hinzugefügt werden kann. Sie ermöglichen es Unternehmen, domänenspezifische Metadaten zu ergänzen.

Kategorien abrufen

query {
  extraCategories(contentType: USER) {
    id title categoryType isRequired
    choiceOptions { id stringValue }
  }
}

Kategorie erstellen

mutation {
  createExtraCategory(extraCategory: {
    title: "Department"
    contentType: USER
    categoryType: SELECT
    choiceOptions: ["Marketing", "Engineering", "Sales"]
  }) {
    extraCategory { id title categoryType }
  }
}

Werte festlegen

mutation {
  setUserExtraCategoryValues(
    userId: "uuid"
    values: [{ extraCategoryId: "cat-uuid", stringValue: "Marketing" }]
  ) {
    ok
  }
}

Notes

Inhaltstypen: USER, GROUP, TRAINING, OFFER
Kategorietypen: TEXT, SELECT, MULTISELECT, BOOLEAN, DATETIME, NUMBER
Zur Verwendung für Filterung, Berichterstattung und benutzerdefinierte Workflows.