---
title: 実行エンドポイント
slug: neurons-for-itsm/admin-user-help/jpn/latest/HWQKQAGsLhe1VETMND_xf
createdAt: 2026-10-29T01:28:26.314Z
---

リクエストで指定されたデータを使用して、Webhook が実行するように設定されているアクションを呼び出して、Webhook を実行できます。

Execute Webhook API を実行するためのメソッド、リクエスト ボディ、ヘッダーの詳細は次のようになります。

| ベースURL                               | https\://\{tenant url}/api/rest/Webhooks/Execute?extension=\{endpoint extension}<br />**注:** エンドポイント拡張子では大文字と小文字が区別されます。                                                                                         |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#ffffff">方法</font>      | 役職                                                                                                                                                                                                               |
| ヘッダー名                                | 認証: REST API キー                                                                                                                                                                                                  |
| <font color="#ffffff">リクエスト本文</font> | 鍵	価値<br />値の形式	価値<br />体<br /><br />テキスト (JSON または XML)<br /><br /> <br /><br /> <br /><br /> <br /><br /><br /><br />リクエストの本文。たとえば、構成されたアクションに提供されるデータ。<br /><br />注: リクエストの Body パラメータは最大 100,000 文字に制限されています。 |
|                                      |                                                                                                                                                                                                                  |

:::ExpandableHeading
## Webhook の実行 - 例

以下は、Rest API を使用して Webhook を実行する方法を示した例です。 この例では、Webhook が Endpoint Extension 値 *MyTestWebhook*で構成されていると想定しています。 Webhook が実行するように構成されているアクションには、 **Update Variables and Stored Values** ブロックの一部として、 **WebhookBody** という変数が必要です。

| メールアドレス                               | https\://\{tenant url}/api/rest/Webhooks/Execute?extension=MyTestWebhook                                                                                                                                                                                                                                                                                  |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#ffffff">方法</font>       | 役職                                                                                                                                                                                                                                                                                                                                                        |
| ヘッダー名                                 | 認証: REST API キー                                                                                                                                                                                                                                                                                                                                           |
| <font color="#ffffff">リクエスト本文</font>  | 鍵	価値<br />値の形式	価値<br />体	テキスト (JSON または XML)<br /><br />\{<br /><br />“someData”:“someDataValue”、<br /><br />“その他のデータ”:“その他のデータ値”<br /><br />}<br /><br /> <br /><br />XML の場合、アクションがリクエストを正しく処理できるように、WebhookBody などの親ノードが必要です。<br /><br />\<WebhookBody><br /><br />\<name>プロジェクト\</name><br /><br />\<summary>要約\</summary><br /><br />\</WebhookBody> |
| <font color="#ffffff">ステータスコード</font> | 200                                                                                                                                                                                                                                                                                                                                                       |


:::

### 失敗した応答

:::ExpandableHeading
## Webhook が見つからないか、拡張機能がありません

シナリオ: 存在しない Webhook を使用しようとします。 または、URL の拡張子部分を省略します。

| メールアドレス                               | https\://\{tenant url}/api/rest/Webhooks/Execute?extension=NonExistentWebhook<br />または<br />https\://\{tenant url}/api/rest/Webhooks/Execute                                                                                                                                                                 |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <font color="#ffffff">方法</font>       | 役職                                                                                                                                                                                                                                                                                                           |
| ヘッダー名                                 | 認証: REST API キー                                                                                                                                                                                                                                                                                              |
| <font color="#ffffff">リクエスト本文</font>  | 鍵	価値<br />値の形式	価値<br />体	テキスト (JSON または XML)<br /><br />\{<br /><br />“someData”:“someDataValue”、<br /><br />“その他のデータ”:“その他のデータ値”<br /><br />}                                                                                                                                                               |
| <font color="#ffffff">ステータスコード</font> | 400 不正なリクエスト                                                                                                                                                                                                                                                                                                 |
| <font color="#ffffff">メッセージ</font>    | 存在しないWEBHOOK:<br />\{<br />"ErrorCode": "UnhandledSystemException-",<br />「メッセージ」: 「未処理のシステム例外: 無効な Webhook 拡張機能が提供されました。 「<br />}<br />拡張子がありません:<br />\{<br />"ErrorCode": "UnhandledSystemException-",<br />「メッセージ」: 「未処理のシステム例外: 実行操作の Webhook 検証に失敗しました。 エラー: ベース URL にエンドポイント拡張子を入力する必要があります。 「<br />} |
:::

:::::ExpandableHeading
## 不正な認証

シナリオ: 認証に誤った、または非アクティブ化された REST API キーを使用しようとしています。

| メールアドレス                               | https\://\{tenant url}/api/rest/Webhooks/Execute?extension=MyTestWebhook                                                                       |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#ffffff">方法</font>       | 役職                                                                                                                                             |
| ヘッダー名                                 | 認証: REST API キー (正しくないか無効)                                                                                                                     |
| <font color="#ffffff">リクエスト本文</font>  | 鍵	価値<br />値の形式	価値<br />体	テキスト (JSON または XML)<br /><br />\{<br /><br />“someData”:“someDataValue”、<br /><br />“その他のデータ”:“その他のデータ値”<br /><br />} |
| <font color="#ffffff">ステータスコード</font> | 401 権限がありません                                                                                                                                   |
| <font color="#ffffff">メッセージ</font>    | \{<br />"code": "ISM\_4001",<br />"description": "無効なセッションキーまたは認証トークン",<br />"メッセージ"： ""、<br />"ヘルプ"： ""<br />}                                |

::::ExpandableHeading
## 本文が長すぎる

シナリオ: 100,000 文字を超えるリクエスト本文を使用しようとしています。

| メールアドレス                               | https\://\{tenant url}/api/rest/Webhooks/Execute?extension=MyTestWebhook                                                                                                   |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#ffffff">方法</font>       | 役職                                                                                                                                                                         |
| ヘッダー名                                 | 認証: REST API キー                                                                                                                                                            |
| <font color="#ffffff">リクエスト本文</font>  | 鍵	価値<br />値の形式	価値<br />体	テキスト (JSON または XML)<br /><br />\{<br /><br />“someData”:“someDataValue”、<br /><br />“その他のデータ”:“その他のデータ値”<br /><br />}<br /><br />100,000 文字を超えます。 |
| <font color="#ffffff">ステータスコード</font> | 400 不正なリクエスト                                                                                                                                                               |
| <font color="#ffffff">メッセージ</font>    | \{<br />"ErrorCode": "UnhandledSystemException-",<br />「メッセージ」: 「未処理のシステム例外: リクエスト本文は 100,000 文字以下にする必要があります」<br />}                                                       |

:::ExpandableHeading
## エンドポイントが正しくないか、ケースが間違っています

シナリオ: 誤って入力された Webhook 拡張機能を使用しようとしています。

| メールアドレス                               | https\://\{tenant url}/api/rest/Webhooks/Execute?extension=blahblahWebhook                                                                     |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#ffffff">方法</font>       | 役職                                                                                                                                             |
| ヘッダー名                                 | 認証: REST API キー                                                                                                                                |
| <font color="#ffffff">リクエスト本文</font>  | 鍵	価値<br />値の形式	価値<br />体	テキスト (JSON または XML)<br /><br />\{<br /><br />“someData”:“someDataValue”、<br /><br />“その他のデータ”:“その他のデータ値”<br /><br />} |
| <font color="#ffffff">ステータスコード</font> | 400 不正なリクエスト                                                                                                                                   |
| <font color="#ffffff">メッセージ</font>    | \{<br />"ErrorCode": "UnhandledSystemException-",<br />「メッセージ」: 「未処理のシステム例外: この Webhook 拡張機能は存在しません。」<br />}                                   |


:::
::::
:::::
