ここでは、Learn365 API を通じたコースセッション 開始日と終了日の取得について説明します。
API を通じたコースセッション 開始日と終了日の取得は、コース ID、セッション ID を用いて行う場合と、そうでない場合とで異なるエンドポイントを使用します。
コースID を用いる場合
コース ID を用いた セッション 開始日と終了日の取得は、以下の手順に沿って行います。
1．https://api.365.systems/ にアクセスし、API キーで認証します。
2．Courses セクションに移動し、GET /odata/v2/Courses Returns the Course by Id を選択し、右上の「Try it out」をクリックします。
3．パラメータを入力します。
- Id＊：key:Id フィールドに、セッションの開始日と終了日を取得するコースの ID を入力します。
- $expand：”CourseSessions” と入力します。これにより、レスポンスにコースセッションの情報が含まれます。
4．「Execute」を選択してリクエストを実行します。
5．Responses ブロックで結果を確認します。
- Code 2xx（202など）は、リクエストが正しく動作したことを示します。
- Response body には、パラメータで指定した ID のコースとそのセッション/ セッション グループの情報のみが含まれます。
- 単独のセッションとセッション グループ内のセッションの開始日と終了日は、それぞれ対応するパラメータの後ろに記述されます。
- セッショングループ（IsGroup が”true”）の場合、StartDate と EndDate パラメータの値は、それぞれ常に「1753-01-01T00:00:00Z」と「9999-12-31T23:59:59.997Z」になります。セッション グループには開始日と終了日はなく、その中のセッション日時が表示されます。
- Download オプションを使用して、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。
セッションID を用いる場合
セッション ID を用いた場合、特定のセッションに関する情報のみを取得できます。
セッション IDを用いた セッション 開始日と終了日の取得は、以下の手順に沿って行います。
1．https://api.365.systems/ にアクセスし、API キーで認証します。
2．CourseSessions セクションを展開し、GET /odata/v2/CourseSessions({Id}) Returns Course Session or Group of Sessions by id を選択し、右上の「Try it out」をクリックします。
3．パラメータを入力します。
- Id＊：key:Id フィールドに特定のセッションの
4．「Execute」を選択してリクエストを実行します。
5．Responses ブロックで結果を確認します。
- Code 2xx（202など）は、リクエストが正しく動作したことを示します。
- Response body には、開始日と終了日を含む、この特定のセッションに関連する情報が表示されます。
- Download オプションを使用して、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。
コース/ セッション ID を用いない場合
コース ID またはセッション ID を用いない場合、セッション 開始日と終了日の取得は、以下の手順に沿って行います。
1．https://api.365.systems/ にアクセスし、API キーで認証します。
2．Courses セクションを展開し、GET /odata/v2/Courses Returns the Course by Id を選択し、右上の「Try it out」をクリックします。
3．必要に応じて、クエリ オプション パラメータを設定して レスポンス データを絞り込むことができます。
例：
$expand フィールドに ”CourseSessions” と入力します。これにより、レスポンスにコースセッションの情報が含まれます。
4．「Execute」を選択してリクエストを実行します。
5．Responses ブロックで結果を確認します。
- Codeの下にある２ＸＸ（例：200）という数字は、リクエストが正しく動作したことを示します。
- Response body には、コースとセッションおよびセッショングループの情報がリスト表示されます。
- セッションの開始日とび終了日は、CourseSessions の下の、”StartDate” と ”EndDate” パラメータにの値です。
- Downloadオプションを使用して、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。