Learn365 APIを使用するには、ユーザーは適切なAPIキーを使用して認証する必要があります。
ここでは、APIキーを取得する方法と、「Swagger」または「Postman」を使用したLearn365 APIの認証方法について説明します。
Learn365 APIキーの取得
この操作に必要なロール:LMS管理者またはMicrosoft 365 グローバル管理者
Learn365では、複数のAPIキーを生成できます。権限レベルは「読み取り専用」と「フルコントロール」の2つがあります。
手順:
1.Learn365管理センター「すべてのカタログ」> 管理 >APIキー管理 に移動します。
2.対象のAPIキーを選択し、[APIキーのコピー]オプションを使用してコピーします。
適切なAPIキーを取得した後は、それを使用して Learn365 APIへのアクセスを認証できます。
SwaggerでLearn365 APIを認証する
手順:
1.https://api.365.systems/ にアクセスし、画面を下にスクロールして「Learn365 API」に移動します。
2.[Authorize]ボタン、または使用する APIエンドポイントのロックアイコンを選択します。「Available authorizations」ポップアップウインドウが開きます。
3.「Basic authorization」の項目に以下を入力します。
- Username:api
- Password:あらかじめコピーしておいた Learn365 API キーを貼り付けます。
4.認証を行うには[Authorize」 を選択します。操作を中止する場合は[Close]を選択します。
認証後、Learn365 APIからログアウトするには
手順:
1.[Authorize]ボタン、または 対象のAPIエンドポイントのロックアイコンを選択します。「Available authorizations」ポップアップウインドウが開きます。
2.[Logout]ボタンを選択します。
Postmanで認証する
手順:
1.「Authorization」タブに移動します。
2.「タイプ」ドロップダウンメニューから、「Basic Auth」タイプを選択します。
3.以下を入力します。
- Username:api
- Password:あらかじめコピーしておいた Learn365 API キーを貼り付けます。
4.[Send]を選択します。
認証情報は自動的にリクエスト内に含まれ、リクエストが送信されるたびに使用されます。