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.

Filtering with ExtraCategories

Overview

Several queries support filtering by ExtraCategory values. This allows finding users, groups, or other objects based on custom field values.

ExtraCategoryFilterInput

input ExtraCategoryFilterInput {
  id: UUID!
  type: ExtraCategoryFilterType!
  stringValue: String
  booleanValue: Boolean
  datetimeValue: DateTime
  dateComparison: DateComparison
}

Filter by text

query {
  paginatedUsers(
    first: 50
    extraCategories: [{ id: "uuid", type: STRING, stringValue: "Marketing" }]
  ) {
    edges { node { id name email } }
    count
  }
}

Filter logic

  • Different category IDs: AND
  • Same category ID: OR