検索

【API】 認定証 ID の取得

  • 更新

ここでは、Learn365 API を通じた認定証 ID の取得について説明します。

この API では、認定証に使用されたテンプレートの ID も取得でます。

 

API を通じた認定証 ID の取得は、以下の手順に沿って行います。

1．https://api.365.systems/  にアクセスし、API キーで認証します。

2．Certificates セクションに移動し、GET /odata/v2/Certificates Returns the list of Certificates owned by current user  を選択し、右上の「Try it out」をクリックします。

Get the ID of a certificate1.png

3．必要に応じて、パラメータを入力します。

クエリ オプション パラメータ を設定して、データの絞り込みやレスポンスに追加のデータと詳細を含めることができます。

  • 特定のコースで付与される認定証のテンプレートを見つけたい場合：

$expand フィールドに「Course」と入力します。これにより、リクエストを実行するとレスポンスにコースのタイトルが含まれます。

Cntr+Fを使用して、レスポンスから目的のコースを検索し、このコースで使用された認定証テンプレートの ID を取得することができます。

  • 特定の認証テンプレートが設定されているコース、またはトレーニングプランを取得したい場合：

$filter フィールドに「Title eq 'certificate's template'」と入力します。'certificate's template' は該当する認証テンプレートのタイトルに置き換えます。

認定証のタイトルは、Learn365 管理センター＞カタログ設定＞ 認定証テンプレートで確認できます。

リクエストを実行すると、レスポンスには、この認定証テンプレートが設定されているコース、またはトレーニングプランが返されます。

Get the ID of a certificate2.png

  • 特定のユーザーに与えられた認定証のリストを取得したい場合

$filter フィールドに「UserId eq ID of the user」 を入力します。ID of the user は該当するユーザーの ID に置き換えます。

入力例：UserId eq 7af3f4b0-65dc-4dfd-a4dc-287733b61e6d

  • 特定のコースに関連する認定証のリストを取得したい場合

$filter フィールドに「CourseId eq ID of the course 」を入力します。ID of the course は該当するコースの ID に置き換えます。

入力例： CourseId eq 6bf3f3b0-65dc-4dfd-a4dc-287733b61e6d 

  • 特定のコースにおける特定のユーザーのすべての認定証を取得したい場合

UserId と CourseID を組み合わせると、レスポンスにはこの場合、$filter フィールドに両方のパラメータを設定します。

入力例：UserId eq 7af3f4b0-65dc-4dfd-a4dc-287733b61e6d and CourseId eq 6bf3f3b0-65dc-4dfd-a4dc-287733b61e6d

 

3．「Execute」を選択してリクエストを実行します。

4．Responses ブロックで結果を確認します。

  • Code 2xx（202など）は、リクエストが正しく動作したことを示します。

Get the ID of a certificate3.png

  • クエリ オプション パラメータが設定されていない場合、Response body には ID を含むテナント上のすべての認定証のデータが含まれます。

Get the ID of a certificate4.png

  • クエリ オプション パラメータが設定された場合、Response body には関連するデータのみが含まれます。認定証 ID は、パラメータの設定に関わらず含まれます。

Get the ID of a certificate5.png

  • Ctrl+Fで特定の認定証を検索することができます。
  • Download オプションを使用すると、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます