Learn365 APIを利用するには、APIキーによる認証が必要です。APIキーは、Postman で認証するためにも使用されます。
ここでは、APIキーを取得し、Learn365 API と Postmanで認証する方法について説明します。
認証用のLearn365 APIキーを取得する
必要なロール:LMS 管理者 または Microsoft 365 グローバル管理者
Learn365 では、グローバル 管理者は「読み取り専用」または「フルコントロール」の2種類の権限で、 複数のAPI キーを生成することができます。
以下の手順で必要な権限レベルの API キーを取得できます。
1.Learn365 管理センター>グローバル設定>「API キー管理」 に移動します。
2.目的の APIキーを選択し「APIキーのコピー」を選択します。
Learn365 APIで認証する
API キーを取得したら、このキーを使って Learn365 API へのアクセスを承認することができます。
1.https://api.365.systems/ にアクセスし、画面を下にスクロールして「Learn365 Cloud API」に移動します。
2.「Authorize」ボタン、または使用するAPIエンドポイントのロックアイコンを選択します。
「Available authorizations」ポップアップウインドウが開きます。
3.Basic authorization の下で次のように入力します。
- Username:api
- Password:コピーしたAPIキーを貼り付けます
4.「Authorize」を選択して認証を行います。キャンセルする場合、「Close」を選択します。
認証後にLearn365 APIからログアウトするには
1.「Authorize」ボタン、または API エンドポイントのロックアイコンを選択します。
「Available authorizations」ポップアップウインドウが開きます。
2.「Available authorizations」ウインドウで「Logout」を選択します。
Postmanで認証する
1.「 Authorization」タブに移動します。
2.「タイプ」ドロップダウンメニューから、「Basic Auth」タイプを選択します。
3.Username と Password フィールドに入力します。
- Username:api
- Password:コピーした API キー
4.「Send」を選択します。
認証データは自動的にリクエスト内に含まれ、リクエストが送信されるたびに使用されます。