Building Blocks et API REST
Blackboard fournit un accès public à une suite d'API REST qui permettent aux développeurs de créer des applications personnalisées qui accèdent à Blackboard. Pour en savoir plus sur nos partenaires d’intégration, consultez le catalogue d’applications Anthology.
Pourquoi utiliser les API REST ?
Utiliser des API REST permet aux développeurs de créer des applications qui ne sont que faiblement couplées au serveur Blackboard. Elles peuvent évoluer n'importe où. Le serveur peut ainsi fournir des informations sans que les API risquent d'interférer avec lui.
Sécurité avec les API REST
Les API REST peuvent fonctionner sous divers modèles de sécurité. Blackboard
Important
Il est préférable d'accorder aux utilisateurs de l'intégration les privilèges minimaux nécessaires pour utiliser l'outil intégré, et non les autorisations d'administrateur système complètes.
Qu'est-il possible de faire avec les API REST ?
Vous pouvez demander l'accès aux API REST Blackboard via le portail des développeurs. Une fois votre application enregistrée, nous générerons une clé et un secret uniques qui vous permettront de passer des appels et d'obtenir les données dont vous avez besoin pour intégrer votre application à notre plateforme. Les applications REST peuvent par exemple accéder aux éléments suivants :
annonces
cours
contenu
pièces jointes
travaux
notes
Pour obtenir la liste complète des points de terminaison REST à la disposition des développeurs, consultez la documentation de l'API REST d'Anthology. Vous pouvez également en apprendre davantage sur le cadre de l'API REST d'Anthology et trouver des informations sur les premiers pas avec l'API REST.
Enregistrer une intégration REST dans Blackboard
Blackboard prend en charge l'intégration d'applications externes créées à l'aide des API REST Blackboard. Avant de pouvoir utiliser une intégration avec Blackboard, un administrateur doit l'enregistrer avec Blackboard.
Avant de commencer à enregistrer l'application, vous devez obtenir un ID d'application. Le développeur peut fournir l'ID directement à l'administrateur ou le joindre à la documentation de prise en charge de l'application.
Dans le panneau de l'administrateur, sous Intégrations, sélectionnez Intégration d'API REST.
Sélectionnez Créer une intégration.
Dans ID de l'application, saisissez l'ID de l'application fourni lors de l'enregistrement de l'application sur le portail des développeurs d'Anthology.
À côté de Utilisateur Learn, sélectionnez Parcourir. Recherchez l'utilisateur Blackboard au nom duquel l'intégration doit agir. En règle générale, une intégration agit en qualité d'administrateur ou d'un autre utilisateur créé pour gérer l'intégration. Idéalement, l'utilisateur dispose uniquement des autorisations nécessaires au bon fonctionnement de l'intégration.
Pour l'intégration d'un tiers, définissez Accès d'utilisateur final sur Oui. Les utilisateurs finaux se connecteront avec leur propre identifiant Blackboardpour utiliser l'intégration. L'accès de chaque utilisateur est alors limité à ses propres autorisations. Si vous définissez l'Accès de l'utilisateur final sur Non, l'intégration conservera l'accès de l'utilisateur Blackboard indiqué sur le formulaire.
Sélectionnez Soumettre pour enregistrer vos paramètres.