Skip to main content

Integraties met REST API’s

Note

Deze documentatie is vertaald met behulp van AI-ondersteunde machinevertaling. Vertalingen worden geleverd 'zoals ze zijn', zonder garantie van de juistheid ervan. De Engelse versie van deze inhoud is de officiële en gezaghebbende bron.

Blackboard LMS biedt openbare toegang tot een suite met REST API’s waarmee ontwikkelaars aangepaste toepassingen kunnen maken die toegang hebben tot Blackboard LMS. Ga naar de Blackboard App Catalog voor meer informatie over onze integratiepartners.

Waarom REST API’s?

Met REST API’s kan een ontwikkelaar toepassingen maken die slechts losjes aan de Blackboard LMS-server zijn gekoppeld. Ze kunnen overal worden gehost. Ze laten de server informatie leveren zonder het risico dat de server wordt verstoord.

Beveiliging met REST API’s

REST API’s kunnen werken met verschillende beveiligingsmodellen. Blackboard LMS REST API-autorisatie maakt gebruik van de industriestandaard OAuth 2.0. Hiermee kun je verzoeken doen op basis van rechten die door de Blackboard LMS-beheerder zijn gedefinieerd. Daarnaast kunnen toepassingen een three-legged variant van het protocol gebruiken. Hierbij worden toepassingen geverifieerd als specifieke Blackboard LMS-gebruikers zonder dat de aanmeldgegevens van gebruikers worden gedeeld. Gebruikers melden zich aan om de toepassing namens hen te laten handelen. De toepassing krijgt dan alleen het toegangsniveau van die gebruiker.

Belangrijk

Geef integratiegebruikers als best practice de minimale rechten die nodig zijn om de geïntegreerde tool te gebruiken, en niet de volledige rechten van een systeembeheerder.

Wat kun je doen met REST API’s?

Je kunt toegang tot de REST API’s van Blackboard aanvragen via het Developer Portal. Nadat je je toepassing hebt geregistreerd, genereren we een unieke sleutel en een uniek geheim, zodat je aanroepen kunt doen en de gegevens kunt opvragen die je nodig hebt om je toepassing met ons platform te integreren. Toepassingen op basis van REST hebben bijvoorbeeld toegang tot:

  • mededelingen

  • cursussen

  • inhoud

  • bijlagen

  • opdrachten

  • cijfers

Raadpleeg de Blackboard REST API-documentatie voor een volledig overzicht van de REST-eindpunten die beschikbaar zijn voor ontwikkelaars. Je kunt ook meer te weten komen over het Blackboard REST API-framework en informatie vinden over de eerste stappen met de REST API.

Een REST-integratie registreren in Blackboard LMS

Blackboard LMS ondersteunt de integratie van externe toepassingen die zijn gebouwd met REST API’s van Blackboard LMS. Voordat je een integratie met Blackboard LMS kunt gebruiken, moet een beheerder deze registreren in Blackboard LMS.

Voordat je de toepassing gaat registreren, heb je een toepassings-ID nodig. De ontwikkelaar kan de ID rechtstreeks aan de beheerder geven of meeleveren met de ondersteuningsdocumentatie van de toepassing.

  1. Ga in het Configuratiescherm voor systeembeheer naar Integraties en selecteer REST API-integraties.

  2. Selecteer Integratie maken.

  3. Voer bij Toepassings-ID de toepassings-ID in die je hebt ontvangen bij het registreren van een toepassing op het Developer Portal van Blackboard.

  4. Selecteer naast Learn-gebruiker de optie Bladeren. Zoek de Blackboard LMS-gebruiker namens wie de integratie moet handelen. Meestal handelt een integratie als beheerder of als een andere gebruiker die voor integratiebeheer is aangemaakt. Idealiter heeft de gebruiker alleen de rechten die de integratie nodig heeft om goed te functioneren.

  5. Stel voor integraties van derden Toegang voor eindgebruikers in op Ja. Eindgebruikers melden zich aan met hun eigen Blackboard LMS-ID om de integratie te gebruiken. De toegang van elke gebruiker is dan beperkt tot zijn of haar eigen rechten. Als je Toegang voor eindgebruikers instelt op Nee, heeft de integratie altijd toegang alsof het de Blackboard LMS-gebruiker is die op het formulier is opgegeven.

  6. Selecteer Verzenden om je instellingen op te slaan.