API 資格情報を生成するには、LDO ポータルの組織管理アカウントが必要です。

API 資格情報の生成

1. 上部のナビゲーション・ドロップダウン・メニューから「デバイス・インサイト」をクリックします。
   
   
   
   
   
   
2. 「構成 / デバイス・インサイト設定」に移動します。
   
   
   
   
   
   
3. 「API 資格情報」をクリックして、「資格情報」パネルを開きます。
   API 資格情報がない場合は、生成する必要があります。
4. 「生成」をクリックします。
   クライアント ID と秘密鍵が生成されます。クリップボードにコピーできます。
1. これらの資格情報を安全な場所に保存し、組織のセキュリティー・ポリシーに従って定期的に再生成します。
2. 既存の API 資格情報を変更する場合は、新しい資格情報を生成する必要があります。
5. 「再生成」をクリックします。
   
   
   
   
   
   
6. 「シークレットを再生成」ウィンドウで、「再生成」をクリックします。
   
   
   
   
   
   
7. 新しいクライアント ID と秘密鍵が発行されます。
   
   
   
   
   
   
1. クライアント ID と秘密鍵は、新しいペアを再生成するまで期限切れになりません。
2. 資格情報を生成したら、組織のデバイスが配置されているリージョンに基づいて適切な URL を使用します。
1. NAEA: https://auth.naea1.uds.lenovo.com
2. EU: https://auth.euwe1.uds.lenovo.com
   
   

 クライアント ID と秘密鍵の新しいペアを生成すると、古いペアは無効になります。

ベアラー・トークンの取得

1. 外部 API を使用して API ベアラー・トークンを生成します。
2. URL - ベース URL + /api/v1/auth/<organization_name>/token
3. ベース URL は、地域 (NA か EU) によって異なります。
4. 本文は x-ww-form-urlencoded で、以下が含まれている必要があります。
1. grant_type: client_credentials
2. client_secret: シークレット (API 資格情報ページから)
3. client_id: id (API 資格情報ページから)

30 分後に有効期限が切れるときに、新しいベアラー・トークンを生成します。

Swagger を使用した API 操作の探索

1. 各 API の詳細が記載された Swagger 仕様 zip ファイル をダウンロードします。
   
2. フォルダー内のファイルを抽出します。
   
   
   
   
   
   
3. ダブルクリックして index.html を開きます。Swagger に LDO デバイス・インサイト (LDI はレガシーです) API のホーム・ページが表示されます。
   
   
   
   
   
   
4. ベアラー・トークンを生成します。

API を試す

1. Swagger で API メソッドを選択します。
   
   
   
   
   
   
2. 呼び出しでベアラー・トークンを使用します。
3. 「試してみる」をクリックします。
   
   
   
   
   
   

API メソッドの例

認証 - API トークン・セッション

Lenovo SDK スナップショット

HTTP 応答

 

ネガティブ API サンプル: Groovy ACME テスト

HTTP 要求

 

HTTP 応答