Blackboard biedt openbare toegang tot een suite met REST-API's waarmee ontwikkelaars aangepaste toepassingen kunnen maken die toegang hebben tot Blackboard Learn.
Ga voor meer informatie over onze integratiepartners naar Anthology App Catalog.
Waarom REST API's?
Met behulp van REST API's kan een ontwikkelaar toepassingen maken die slechts losjes zijn gekoppeld aan de Blackboard Learn-server. Ze kunnen overal staan. Ze laten de server informatie bieden zonder mogelijke interferentie met de server te riskeren.
Beveiliging met REST API's
REST API's kunnen onder verschillende beveiligingsmodellen werken. Blackboard REST API-autorisatie maakt gebruik van de sectorstandaard OAuth 2.0. Hiermee kun je aanvragen indienen op basis van bevoegdheden die zijn gedefinieerd door de Blackboard Learn-beheerder. Bovendien kunnen toepassingen gebruik maken van een drieledige variatie van het protocol. Op deze manier worden toepassingen geverifieerd als specifieke Blackboard Learn-gebruikers zonder dat de toegangsgegevens van gebruikers worden gedeeld. Gebruikers melden zich aan om de toepassing toestemming te geven uit hun naam te handelen. De toepassing krijgt dan alleen het toegangsniveau voor die gebruiker.
Het wordt aanbevolen om gebruikers van de integratie de minimale bevoegdheden te geven die nodig zijn om de geïntegreerde tool te gebruiken. Niet alle machtigingen voor systeembeheerders.
Wat kun je doen met REST API's?
Je kunt toegang tot de Blackboard REST API's aanvragen via de Ontwikkelaarsportaal. Nadat je je toepassing hebt geregistreerd, genereren we een unieke sleutel en uniek geheim zodat je kunt aanroepen en de benodigde gegevens kunt opvragen om je toepassing te integreren met ons platform. REST-toepassingen hebben toegang tot bijvoorbeeld:
- mededelingen
- cursussen
- inhoud
- bijlagen
- opdrachten
- cijfers
Raadpleeg de Learn API-documentatie voor een volledig overzicht van REST-eindpunten die beschikbaar zijn voor ontwikkelaars.
Meer informatie over het Blackboard REST API-framework
Meer informatie over de eerste stappen met Learn REST API
Een REST-integratie registreren in Blackboard Learn
Blackboard Learn ondersteunt de integratie van externe toepassingen die zijn gebouwd met Blackboard Learn REST API's. Voordat je een integratie met Blackboard Learn kunt gebruiken, moet een beheerder deze met Blackboard Learn registreren.
Voordat je begint met het registreren van de toepassing, moet je een toepassings-ID verkrijgen. De ontwikkelaar kan de ID rechtstreeks aan de beheerder of bundel verstrekken met de ondersteuningsdocumentatie voor de toepassing.
- Ga in het Configuratiescherm voor systeembeheer naar Integraties en selecteer REST API-integraties.
- Selecteer Integratie maken.
- Voer bij Toepassings-ID de toepassings-ID in die je hebt opgegeven door een toepassing te registreren op het Ontwikkelaarsportaal van Anthology.
- Naast Learn-gebruiker selecteer je Bladeren. Zoek de Blackboard-gebruiker als wie de integratie moet handelen. Een integratie werkt meestal als Beheerder of een andere gebruiker die is gemaakt voor integratiebeheer. In het ideale systeem beschikt de gebruiker alleen over de machtigingen die de integratie nodig heeft om goed te kunnen functioneren.
- Voor integratie van derden stel je Toegang voor eindgebruikers in op Ja. Eindgebruikers melden zich aan met hun eigen Blackboard Learn-ID om de integratie te gebruiken. De toegang van elke gebruiker is dan beperkt tot diens eigen machtigingen. Als je Toegang voor eindgebruikers hebt ingesteld op Nee, heeft de integratie altijd toegang alsof het de Blackboard Learn-gebruiker is die op het formulier is aangegeven.
- Selecteer Verzenden om je instellingen op te slaan.
