Skip to main content

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.

  1. Dans le panneau de l'administrateur, sous Intégrations, sélectionnez Intégration d'API REST.

  2. Sélectionnez Créer une intégration.

  3. 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.

  4. À 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.

  5. 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.

  6. Sélectionnez Soumettre pour enregistrer vos paramètres.