Learning Management System for Office 365 – SharePoint Online

APIサポート

LMS365はeラーニングシステムとしては珍しく、ERPやHRシステム、レポートツールなどの他のエンタープライズアプリケーションと連携するためのAPIを提供しております。
システム間での相互連携を行うことで、組織内の業務プロセスを合理化しパフォーマンスを向上させる鍵となります。

APIで何が実現できるのか?

  • 学習コースや教材の管理
  • 受講者や学習コースに関する統計情報の取得
  • 受講者の学習コースへの参加登録手続き … etc

Open Data Protocol

OData (Open Data Protocol) はRESTful APIを使用してWebアプリケーションを構築するために、ISO/IECが定めたデータアクセスの標準方式です。

ODataはリクエスト要求とその応答ヘッダー、ステータスコードやHTTPメソッド、クエリオプションを定義するための様々な手法でRESTful APIを使用してビジネスロジックを構築するのに役立ちます。

また、変更時のトラッキング、プロシージャやファンクションの定義、非同期での実行するバッチプログラムに関するガイダンスも提供します。
OData RESTful APIは簡単に使用することが出来ます。

データ保護に関する3つの法則

データアクセスの限定

ODataサービスで提供するデータは、読み取り専用となります。

データの保護

httpsを通じたアクセスのみが許可されており、データアクセスにはAPI秘密Keyが必要となります。

データの可用性

ODataは様々なデバイスやサービスからデータを使用することが出来ます。

制限事項

拡張レベルのサポートは1段階目までとなります

データ構造

トップレベルエンティティ

Data Structure

複数リージョン対応

LMS365は現在4つのリージョンにてサービスを提供しておりますが、LMS365インストール時に選択したリージョンに対応するAPIエンドポイントにアクセスすることで最高パフォーマンスを得ることが出来ます。

リージョンAPI エンドポイント
アメリカ(Central US)https://cus-api.365.systems
ヨーロッパ(North Europe)https://ne-api.365.systems
日本(Japan East)https://je-api.365.systems
オーストラリア(Australia East)https://au-api.365.systems

旧来のエンドポイントである「https://api.365.systems」についても互換性を保っておりご利用頂くことが可能です。
このエンドポイントはAPI認証情報からお客様のリージョンを判定し、適切なリージョンのエンドポイントに導くリバースプロキシのように機能いたします。

(例)テナントリージョンの取得方法

テナントのエンドポイント情報を取得するには、GETリクエストを次のエンドポイントに送信します。

以下のような応答が得られます。

取得したこの情報はキャッシュに保存されます。

APIキーによる認証

お使いのLMS365のAPIキーについては弊社サポートまでご連絡ください。
APIキーを取得した後、LMS365 APIエンドポイントへの基本認証に使用することができます。
テナント内の全てのデータにアクセスする際には、こちらの認証方法を使用してください。

Authorization: Bearerヘッダーによるトークン認証

LMS365をお使いのSharePoint Onlineページ上からJavaScriptを使ってアクセスする場合は、こちらの認証方式になります。
この方法では、現在SharePoint Onlineにログインしているユーザー権限の下でAPIを要求する機能を提供します。

使用例

  1. 目的のSharePoint OnlineページにスクリプトエディタWebパーツを配置し、LMS365 APIにアクセスするJavaScriptを記述できるようにします。
  2. 次に、LMS365 APIトークンと、トークンを使用するためのアプリケーションコードを設定します。

LMS365のJavaScriptライブラリーを使用することで認証レイヤーをカプセル化出来ます。

コースカタログのインストレーションを使用し、現在のログインユーザーでLMS365 APIを照会する為にQueryExecutorインスタンスを生成します。

以下の例は、全ての学習コース情報を取得した上で、最初のコースの登録情報を取得するコードです。

APIへのリクエストは、現在のログインユーザー権限で実行され、APIエンドポイントは現在のユーザー固有のデータを返します。
ここがAPIキー認証との大きな違いです。

コードサンプル:現在のログインユーザーを学習コースに登録

  • Facebook
  • Hatena
  • twitter
  • Google+
PAGETOP
Copyright © Sofia,Inc. All Rights Reserved.