Learn365 API を通じた スキル ID と スキル レベル ID の取得について説明します。
注記：
新しいスキル エンドポイントが実装されました。従来のコンピテンシー エンドポイントは、今後の Learn365 リリースで廃止される予定です。新しい Skills エンドポイントへの移行を推奨します。
ここでは、新しいエンドポイントと従来のエンドポイントを使用したスキル ID の取得について説明します。
新しいエンドポイント：UserSkills
新しいエンドポイント「UserSkills」でのスキル ID と スキル レベル ID の取得は、以下の手順に沿って行います。
1．https://api.365.systems/ にアクセスし、API キーで認証します。
2．UserSkills セクションに移動し、GET /services/skills/UserSkills Returns all users skills を選択し、右上の［Try it out］をクリックします。
補足：
クエリ オプション パラメータ を設定して レスポンス データを絞り込むことができます。
3．［Execute］を選択してリクエストを実行します。
4．Responses ブロックで結果を確認します。
- Code2xx（202など）は、リクエストが正しく動作したことを示します。
- Response body にはテナント上のすべてのスキルの情報がリストされます。
- Ctrl+F でスキルを検索することができます。
- Download オプションを使用すると、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。
従来のエンドポイント：UserCompetencies
1．https://api.365.systems/ にアクセスし、API キーで認証します。
2．UserCompetencies セクションに移動し、GET /odata/v2/UserCompetencies Returns the list of user competencies (skills) owned by current user を選択し、右上の［Try it out］をクリックします。
補足：
クエリ オプション パラメータ を設定して、データの絞り込みやレスポンスに追加のデータと詳細を含めることができます。
例えば、$expand フィールドに「Competency, User」を設定すると、レスポンスにスキル名や付与されたユーザー名など、追加の情報を含むことができます。
3．［Execute］を選択してリクエストを実行します。
4．Responses ブロックで結果を確認します。
- Code 2xx（202など）は、リクエストが正しく動作したことを示します。
- Response body には、その時点でログインしているユーザーのすべてのスキルのリストが表示されます。
- $expand フィールドに「Competency」が設定されている場合、Response body には追加の詳細情報が表示され、”CompetencyID” と ”LevelId” パラメータを見つけることができます。
- Download オプションを使用すると、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。