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

Application and Structure

An ExtraCategory is a custom field that can be attached to users, groups, trainings, or offers. They allow organizations to add domain-specific metadata.

Get categories

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

Create category

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

Set values

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

Notes

Content types: USER, GROUP, TRAINING, OFFER
Category types: TEXT, SELECT, MULTISELECT, BOOLEAN, DATETIME, NUMBER
Use for filtering, reporting, and custom workflows.