SkillUpのレポートAPIを使用すると、組織からスキルシグナル、バッジ、認定データをプログラムで抽出できます。これらのAPIを使用して、学習の洞察をHRシステムと連携させたり、カスタマイズされたレポートを作成したり、学習成果をビジネスの影響に結びつけたりできます。

利用可能なエンドポイント

レポートAPIの設定‬

SkillUp APIは、安全なアクセスのためにOAuth 2.0クライアント資格情報フローを使用します。認可されたシステムのみがレポート情報をリクエストおよび取得できます。

レポートAPIを設定するには：

‭ステップ1：OAuth資格情報の生成‬

1. ‭管理者アカウントを使用して SkillUp にログインします。

2. 右上のプロフィールアイコンをクリックし、設定を選択します。

3. 新しいアプリケーションを登録をクリックします。

4. アプリケーションの名前を入力します。

5. アプリケーションを登録をクリックします。

6. クライアントIDとクライアントシークレットをクリップボードにコピーするか、JSONをダウンロードをクリックして資格情報をファイルとして保存します。

   重要な注意点：クライアントシークレットは生成時に一度だけ表示されます。ダイアログを閉じる前に安全に保存してください。再取得はできません。

あなたのアプリケーションは正常に登録されました。これでAPIリクエストを開始できます。

‭ステップ2：アクセス トークンのリクエスト‬

‭セキュリティ対策として、最初に /v1/oauth2/tokenエンドポイントにPOSTリクエストを送信してアクセス トークンを取得する必要があります。

Authorizationヘッダーには、クライアント資格情報をBase64エンコードしたものを含める必要があります。

1. クライアントIDとクライアントシークレットをコロン（:）で結合します。
   例：client_id:client_secret

2. 文字列をBase64でエンコードします。

3. エンコードされた文字列の前にBasicを付けてAuthorizationヘッダーを作成します。
   例：Basic <base64_encoded_string>。

例

client_id = "abc123" と client_secret = "def456" の場合
結合： “abc123:def456”

Base64エンコード：”YWJjMTIzOmRlZjQ1Ng==”

最終ヘッダー：”Basic YWJjMTIzOmRlZjQ1Ng==”

リクエスト

curl -X POST https://www.hackerrank.com/skillup/api/v1/oauth2/token \
-H "Authorization: Basic <base64_encoded_credentials>" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials"

ヘッダー

ボディパラメータ

レスポンス

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 600
}

‭ステップ3：SkillUp APIにアクセス‬

‭有効なアクセストークンを取得したら、それを使用してSkillUp Reporting APIに呼び出します。

リクエストのAuthorizationヘッダーにトークンを含めてください。

例のリクエスト

curl -X GET https://www.hackerrank.com/skillup/api/v2/credentials \
-H "Authorization: Bearer <access_token>"

エラー処理

ベストプラクティス

• 資格情報を安全に保管してください。クライアント側のコードにクライアント資格情報を公開しないでください。

• トークンは10分間有効です。アクセス トークンをキャッシュして再利用し、毎回新しいものを生成しないでください。

• 現在のトークンの有効期限が切れる前に新しいトークンをリクエストしてください。

レート制限

詳細については、skillup-support@hackerrank.comまでお問い合わせください。‭