ここでは、Learn365 API を通じた、Learn365 におけるユーザーのアクティブな登録 ID の取得について説明します。
API を通じたユーザーのアクティブな登録 IDの取得は、以下の手順に沿って行います。
1. https://api.365.systems/ にアクセスし、APIキーで認証します。
2.Users セクションに移動し、GET /odata/v2/Enrollments Returns the list of current user's active Enrollments を選択し、右上の「Try it out」を選択します。
クエリ オプション パラメータを設定して レスポンス データを絞り込むことができます。
- テナントで有効なすべてのユーザーの登録データを取得したい場合は、フィールドは空のままにします。
- レスポンス データを絞り込みたい場合は、クエリフィールドにクエリパラメータを指定します。レスポンス データには、絞り込まれたデータのみが含まれます。
- レスポンスに登録されているすべてのセッションの ID とタイトルを含めるには、$expand フィールドに「AllCourseSessions」と入力します。
例: 特定のコースのアクティブな登録の情報を取得する場合: $filter フィールドに「CourseId eq ID」 と入力します(IDは関連するコースのID)。コース IDの取得については、こちらを参照してください。 このコースの特定の受講者のアクティブな登録 ID を取得したい場合、ユーザーIDを取得し、レスポンス データをさらに絞り込みます。
|
3.「Execute」を選択してリクエストを実行します。
4.Responses ブロックで結果を確認します。
- Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
- クエリ オプション パラメータが設定されていない場合、Response body には登録 ID を含むテナント上のすべてのユーザーのすべてのアクティブな登録に関するデータが表示されます。
- Id パラメータの横の値は、各コースの各ユーザのユニークな登録 IDを示しています。
- クエリ オプション パラメータが設定された場合、Response body には関連するデータのみが表示されます。
- Ctrl+Fで特定の ID を検索することができます。
- Downloadオプションを使用して、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。