Learn365 APIでAPIキーを使用して認証する方法

  • 更新

Learn365 APIを使用するには、ユーザーは適切なAPIキーを使用して認証する必要があります。

ここでは、APIキーを取得する方法と、「Swagger」または「Postman」を使用したLearn365 APIの認証方法について説明します。

 

Learn365 APIキーの取得

この操作に必要なロール:LMS管理者またはMicrosoft 365 グローバル管理者

Learn365では、複数のAPIキーを生成できます。権限レベルは「読み取り専用」と「フルコントロール」の2つがあります。

手順:

1.Learn365管理センター「すべてのカタログ」> 管理 >APIキー管理 に移動します。

2.対象のAPIキーを選択し、[APIキーのコピー]オプションを使用してコピーします。

authorize with an API key-1.png

 

適切なAPIキーを取得した後は、それを使用して Learn365 APIへのアクセスを認証できます。

 

SwaggerでLearn365 APIを認証する

手順:

1.https://api.365.systems/  にアクセスし、画面を下にスクロールして「Learn365 API」に移動します。

2.[Authorize]ボタン、または使用する APIエンドポイントのロックアイコンを選択します。「Available authorizations」ポップアップウインドウが開きます。

authorize with an API key-2.png

3.「Basic authorization」の項目に以下を入力します。 

  • Username:api
  • Password:あらかじめコピーしておいた Learn365 API キーを貼り付けます。 

4.認証を行うには[Authorize」 を選択します。操作を中止する場合は[Close]を選択します。

authorize with an API key-3.png

 

認証後、Learn365 APIからログアウトするには

手順:

1.[Authorize]ボタン、または 対象のAPIエンドポイントのロックアイコンを選択します。「Available authorizations」ポップアップウインドウが開きます。

2.[Logout]ボタンを選択します。

authorize with an API key-4.png

 

Postmanで認証する

手順:

1.「Authorization」タブに移動します。

2.「タイプ」ドロップダウンメニューから、「Basic Auth」タイプを選択します。

3.以下を入力します。

  • Username:api
  • Password:あらかじめコピーしておいた Learn365 API キーを貼り付けます。 

4.[Send]を選択します。

認証情報は自動的にリクエスト内に含まれ、リクエストが送信されるたびに使用されます。

authorize with an API key-5.png