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.

Certificate

Use Cases

Certificates are official documents that can be issued to users upon completion of training or events.

Issue certificate

mutation {
  issueCertificate(
    certificateId: "cert-uuid"
    userId: "user-uuid"
    score: 85
  ) {
    receivedCertificate { id issuedAt expiresAt }
  }
}

Query certificates

query {
  certificates {
    id name expirationMonths
    receivedCertificates { id user { name } issuedAt }
  }
}

Notes

  • Certificates can have expiration dates.
  • They can be linked to skills for compliance tracking.