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

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 Learn. 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é. L'autorisation de l'API REST Blackboard utilise la norme du secteur OAuth 2.0. Cette norme permet de créer des requêtes en fonction des privilèges définis par l'administrateur de Blackboard Learn. De plus, les applications peuvent utiliser une variante à trois étapes du protocole. Cette approche authentifie les applications en tant qu'utilisateurs spécifiques de Blackboard Learn sans partager leurs informations d'identification. Les utilisateurs se connectent pour autoriser l'application à agir en leur nom. L'application n'obtient alors que le niveau d'accès dont bénéficie cet utilisateur.

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
  • devoirs
  • notes

Pour obtenir la liste complète des points de terminaison REST disponibles pour les développeurs, consultez la documentation de l'API Learn.

En savoir plus sur Le cadre de l'API REST Blackboard

En savoir plus sur les premiers pas avec l'API REST Learn

Enregistrer une intégration REST dans Blackboard Learn

Blackboard Learn prend en charge l'intégration d'applications externes créées à l'aide des API REST Blackboard Learn. Avant de pouvoir utiliser une intégration avec Blackboard Learn, un administrateur doit l'enregistrer auprès de Blackboard Learn.

Avant de commencer à enregistrer l'application, vous devez obtenir son ID. 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. Près 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 les intégrations tierces, définissez l'Accès de l'utilisateur final sur Oui. Les utilisateurs finaux se connecteront avec leur propre ID Blackboard Learn pour 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 Learn indiqué sur le formulaire.
  6. Sélectionnez Valider pour enregistrer vos paramètres.