---
title: Web API の操作
slug: neurons-for-itsm/admin-user-help/jpn/latest/web-api
createdAt: 2026-10-29T01:28:25.008Z
---

- [Web サービス API について](docId\:MloDT9eGnhPcxa0ZOMt2w)
- [申請項目へのリンクの作成](docId\:MloDT9eGnhPcxa0ZOMt2w)
- [タイムアウトについて](docId\:MloDT9eGnhPcxa0ZOMt2w)
- [Cloud Connect API メソッド](docId\:MloDT9eGnhPcxa0ZOMt2w)
- [API キーの操作](docId\:MloDT9eGnhPcxa0ZOMt2w)

## Web サービス API について

サービス マネージャWeb API モジュールは、外部 Web アプリケーションをセルフサービス ポータルおよびサービス カタログと統合するために使用できるサンプル メソッドを備えたフレームワークです。 開発者は、 サービス マネージャ データベースからデータを取得し、特定の サービス マネージャ アプリケーション ページへのナビゲーション リンクを公開できます。 外部ユーザーに対してパススルー認証を提供することもできます。

この API は自己完結型の開発者ツールであり、 サービス マネージャ Web API を外部アプリケーション ページに読み込む方法、認証方法などに関する手順が含まれています。

## 申請項目へのリンクの作成

1. 構成コンソールから、「 **Extend** 」 > 「 **Web Services API** 」をクリックして、「 **Ivanti HEAT API** 」ワークスペースに移動します。
2. 左側のペインから、「 **SearchOfferings**」をクリックします。 アプリケーションは、利用可能な申請項目のリストを表示します。

:::Paragraph{indent="1"}
*Ivanti ヒートAPI*
:::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/c4hKcevYLoPe8MgrjmWEp_ivanti-heat-api.png" position="flex-start" size="100" width="1667" height="717" initialPath="../../Resources/Images/help-images/Ivanti-HEAT-API.png" githubPath="Admin-User-Jpn/Content/Resources/Images/help-images/Ivanti-HEAT-API.png" showCaption="false" indent="1"}

3. リストからサービスをクリックします。 URL 領域にリンクがある Web ページが開きます。 例えば：

```bash
http://heatsoftware.com/?Scope=SelfService
&CommandId=New
タブ=サービスカタログ
&Template=AE3E70C3BBFF470597EA1134FECE464D
フレームレス=偽
&role=Admin#1390514684377
```

4. リンクから役割を削除します。 残りは、サービス提供へのリンクとしてユーザーに送信できます。

## タイムアウトについて

Web サービス呼び出しを行うときは、次の点に注意してください。

- クエリに 60 秒以上かかると、Microsoft SQL タイムアウト例外が発生します。
- サービス マネージャアプリケーション サーバーで API 呼び出しが 90 秒以上実行されると、要求タイムアウトが発生します。

## Cloud Connect API メソッド

サービス申請の操作を可能にするために、 サービス マネージャ Web API に次のメソッドが追加されました。

| 方法                   | 説明                                              |
| -------------------- | ----------------------------------------------- |
| GetCategories        | サービス カタログで使用可能なカテゴリのリストを返します。                   |
| GetCategoryTemplates | 指定されたカテゴリに属する、サービス カタログ内の申請項目のリストを返します。         |
| GetAllTemplates      | サービス カタログ内の申請項目の完全なリストを返します。                    |
| GetSubscriptionId    | 現在のユーザーに対して提供されている申請項目に対応するサブスクリプション ID を取得します。 |
| GetPackageData       | 指定された申請項目の詳細を取得します。                             |
| ユーザーアクセスリクエストの提供     | 現在のユーザーが申請項目にアクセスする権限を持っているかどうかを確認します。          |
| リクエストを送信             | ユーザーに代わって サービス申請を作成して送信します。                     |
| GetRequestData       | サービス申請のデータを取得します。                               |
| サービス要求検証リストデータの取得    | サービス申請パラメータの許容検証リスト データを取得します。                  |

## API キーの操作

- [APIキーについて](docId\:MloDT9eGnhPcxa0ZOMt2w)
- [API キーの表示](docId\:MloDT9eGnhPcxa0ZOMt2w)
- [キーグループの追加](docId\:MloDT9eGnhPcxa0ZOMt2w)
- [API キーを API キー グループにリンクする](docId\:MloDT9eGnhPcxa0ZOMt2w)
- [API キーの無効化](docId\:MloDT9eGnhPcxa0ZOMt2w)
- [API キーの削除](docId\:MloDT9eGnhPcxa0ZOMt2w)

### APIキーについて

ユーザー グループを 1 つ以上の API (アプリケーション プログラミング インターフェイス) キーにリンクできます。API キーはアクセスを認証し、API の使用状況を追跡するために使用できるコードです。 API キーは有効期限のあるユーザー セッションに関連付けられていません。

デスクトップおよびサーバー管理 (DSM) を使用する場合、API キーを使用して、特定のコンピューターにインストールされている DSM アプリケーションにアクセスしようとする特定のユーザーにアクセスを許可できます。

ユーザー アクセスを許可するには、API キーを特定のキー グループにリンクする必要があります。 キー グループを使用して API キー アクセスを構造化します。 たとえば、API キーの使用を特定のユーザー、または特定のロールでログインするユーザー グループに制限できます。

### API キーの表示

1. 構成コンソールから、\[ **構成&#x20;**] > \[**&#xA0;セキュリティ コントロール&#x20;**] > \[**&#xA0;API キー** ] をクリックして、\[ **API キー** ] ワークスペースを開きます。 アプリケーションは API キーを表示します。

:::Paragraph{indent="1"}
*API キー ワークスペース*
:::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/-AfeVkt57M0_Xj3U5Snwf_deactivateapikey.png" position="flex-start" size="100" width="923" height="426" initialPath="../../Resources/Images/help-images/deactivate_API_key.png" githubPath="Admin-User-Jpn/Content/Resources/Images/help-images/deactivate_API_key.png" showCaption="false" indent="1"}

### キーグループの追加

1. 構成コンソールから、\[ **構成&#x20;**] > \[**&#xA0;セキュリティ コントロール&#x20;**] > \[**&#xA0;API キー** ] をクリックして、\[ **API キー** ] ワークスペースを開きます。 API キーのリストが表示されます。
2. キ**ーグループの追加を**クリックします。 空白のキー グループ フォームが表示されます。
3. フィールドに情報を入力します。
   - **名前**: この API キー グループの一意の名前。
   - **説明**: この API キー グループの簡単な説明。
4. キ**ー グループの保存を**クリックします。 API キー グループがリストに表示されます。

### API キーを API キー グループにリンクする

1. 構成コンソールから、\[ **構成&#x20;**] > \[**&#xA0;セキュリティ コントロール&#x20;**] > \[**&#xA0;API キー** ] をクリックして、\[ **API キー** ] ワークスペースを開きます。
2. A**PI キーの追加を**クリックします。 アプリケーションは、 **新しい API キー** ワークスペースを表示します。
3. フィールドに情報を入力します。

| 分野    | 説明                                                                                                                                             |
| ----- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| 参照ID  | アプリケーションによって自動的に生成されます。 このキー グループにのみ関連付けられます。                                                                                                  |
| 有効化   | この API キーがアクティブ化されていることを指定します。 このオプションはデフォルトで選択されています。 このグループをアクティブ キー グループとして無効にするには、このオプションのチェックを外します。 チェックされていない場合、このキーはアクティブ化されるまで使用できません。 |
| 説明    | API キーの説明。                                                                                                                                     |
| に代わって | ユーザに代わって新しい API キーを作成する従業員。 従業員を 1 つまたは複数の特定の住所に制限できます。 リストから従業員を選択し、「 **選択**」をクリックします。                                                        |
| 役割    | この従業員に関連付ける役割。                                                                                                                                 |

4. デフォルトでは、このユーザーは任意の IP アドレスから API にアクセスできます。 従業員を 1 つまたは複数の特定のアドレスに制限するには、「 **新しい IP を追加**」をクリックします。 有効な IP アドレスを入力し、\[ **OK**] をクリックします。
5. キ**ーを保存を**クリックします。
6. **\[戻る]** をクリックしてメイン **\[API キーの管理]** ページに戻ります。

### API キーの無効化

1. 構成コンソールから、\[ **構成&#x20;**] > \[**&#xA0;セキュリティ コントロール&#x20;**] > \[**&#xA0;API キー** ] をクリックして、\[ **API キー** ] ワークスペースを開きます。
2. 非アクティブ化するキーの横にある「 **非アクティブ化** 」をクリックします。 リンクがアクティブに変わります。

### API キーの削除

1. 構成コンソールから、\[ **構成&#x20;**] > \[**&#xA0;セキュリティ コントロール&#x20;**] > \[**&#xA0;API キー** ] をクリックして、\[ **API キー** ] ワークスペースを開きます。
2. 削除するキーの横にある「 **削除** 」をクリックします。 キーが表示されなくなりました。
