Learn365 API を通じた スキル ID と スキル レベル ID の取得について説明します。
注記：
新しいスキル エンドポイントが実装されました。従来のコンピテンシー エンドポイントは、現在 2025 年 8 月 18 日 (月) に予定されている Learn365（v.3.64）リリースで非推奨になり、最終的に廃止され、スキル エンドポイントに置き換わります。
Microsoft power app などでコンピテンシー エンドポイントを使用されている場合、エンドポイントが廃止される前に新しいスキル エンドポイントへの移行をお勧めします。
ここでは、新しいエンドポイントと従来のエンドポイントを使用したスキル 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 フォーマットでローカルデバイスに保存できます。