Welkom bij de API-documentatie van Pluvo. Dit document geeft een overzicht van de belangrijkste concepten en de onderliggende structuur van het Pluvo-platform. Het is bedoeld als startpunt voor ontwikkelaars die integraties bouwen of data synchroniseren met Pluvo.
Deelnemers, trainers, planners of managers — iedereen die inlogt in Pluvo is een User. Gebruikers kunnen extra gegevens (via extraFields) bevatten en worden gekoppeld aan groepen of rollen.
Organisatorische eenheden die gebruikers groeperen. Groepen bepalen toegang tot trainingen en kunnen eigen instellingen en managers hebben.
Een Training bevat leerinhoud, voortgangsregels, en planning. Wat gebruikers als een "leerlijn" zien in de interface, heet in de API een Training.
Offer is het overkoepelende inschrijfaanbod. Een OfferEvent is een concreet instapmoment. Gebruikers schrijven zich in op een OfferEvent.
PortfolioItem slaat bewijsstukken, prestaties of certificaten op. PortfolioReport is een geavanceerde query voor het analyseren van voortgang, scores en tijdsbesteding.
Binnen een Training vind je Modules die e-learning content bevatten zoals video’s, theorie, opdrachten of externe LTI-modules.
Pluvo kan gebeurtenissen pushen naar jouw systeem. Voorbeelden zijn USER_CREATED, TRAINING_FINISHED en COURSE_FINISHED.
De Pluvo API is opgebouwd als een GraphQL API. Belangrijke kenmerken:
User, Training, Group, etc.)refvelden voor externe koppelingenVoorbeeldstromen binnen Pluvo:
updateOrCreateUser en updateExtraCategoryValues voor robuuste synchronisatie.archiveUsers, archiveOffers, etc.).PortfolioReport voor evaluatie- en monitoringdoeleinden.ref, id, en contentType.