REST API ドキュメントの一部は最近移動されました。 探しているものが見つからない場合は、Actions REST API ページを試してみてください。
グローバル Webhook
この REST API を使い、企業のグローバル Webhook を管理します。
グローバルwebhookについて
これらのエンドポイントは認証されたサイト管理者のみが利用できます。通常のユーザーには 404
応答が届きます。 グローバル Webhook を構成する方法については、「グローバル Webhook について」を参照してください。
グローバル Webhook は企業に自動的にインストールされます。 グローバル webhook を使用して、Engerprise のユーザ、Organization、Team、およびリポジトリのルールを自動的に監視、対応、強制することができます。
グローバル Webhook は、Organization、ユーザー、リポジトリ、チーム、メンバー、メンバーシップ、フォーク、および ping イベントの種類をサブスクライブできます。
List global webhooks
"List global webhooks" のパラメーター
ヘッダー |
---|
名前, Type, 説明 |
accept string Setting to |
クエリ パラメーター |
名前, Type, 説明 |
per_page integer The number of results per page (max 100). Default: |
page integer Page number of the results to fetch. Default: |
"List global webhooks" の HTTP 応答状態コード
状態コード | 説明 |
---|---|
200 | OK |
"List global webhooks" のコード サンプル
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/admin/hooks
Response
Status: 200
[
{
"type": "Global",
"id": 1,
"name": "web",
"active": true,
"events": [
"organization",
"user"
],
"config": {
"url": "https://example.com",
"content_type": "json",
"insecure_ssl": "0",
"secret": "********"
},
"updated_at": "2017-12-07T00:14:59Z",
"created_at": "2017-12-07T00:14:59Z",
"url": "https://HOSTNAME/admin/hooks/1",
"ping_url": "https://HOSTNAME/admin/hooks/1/pings"
}
]
Create a global webhook
"Create a global webhook" のパラメーター
ヘッダー | ||||||||
---|---|---|---|---|---|---|---|---|
名前, Type, 説明 | ||||||||
accept string Setting to | ||||||||
本文のパラメーター | ||||||||
名前, Type, 説明 | ||||||||
name string 必須Must be passed as "web". | ||||||||
config object 必須Key/value pairs to provide settings for this webhook. | ||||||||
Properties of |
名前, Type, 説明 |
---|
url string 必須The URL to which the payloads will be delivered. |
content_type string The media type used to serialize the payloads. Supported values include |
secret string If provided, the |
insecure_ssl string Determines whether the SSL certificate of the host for |
events
array of strings The events that trigger this webhook. A global webhook can be triggered by user
and organization
events. Default: user
and organization
.
active
boolean Determines if notifications are sent when the webhook is triggered. Set to true
to send notifications.
Default: true
"Create a global webhook" の HTTP 応答状態コード
状態コード | 説明 |
---|---|
201 | Created |
"Create a global webhook" のコード サンプル
curl -L \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/admin/hooks \
-d '{"name":"web","events":["organization","user"],"config":{"url":"https://example.com/webhook","content_type":"json","secret":"secret"}}'
Response
Status: 201
{
"type": "Global",
"id": 1,
"name": "web",
"active": true,
"events": [
"organization",
"user"
],
"config": {
"url": "https://example.com",
"content_type": "json",
"insecure_ssl": "0",
"secret": "********"
},
"updated_at": "2017-12-07T00:14:59Z",
"created_at": "2017-12-07T00:14:59Z",
"url": "https://HOSTNAME/admin/hooks/1",
"ping_url": "https://HOSTNAME/admin/hooks/1/pings"
}
Get a global webhook
"Get a global webhook" のパラメーター
ヘッダー |
---|
名前, Type, 説明 |
accept string Setting to |
パス パラメーター |
名前, Type, 説明 |
hook_id integer 必須The unique identifier of the hook. |
"Get a global webhook" の HTTP 応答状態コード
状態コード | 説明 |
---|---|
200 | OK |
"Get a global webhook" のコード サンプル
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/admin/hooks/HOOK_ID
Response
Status: 200
{
"type": "Global",
"id": 1,
"name": "web",
"active": true,
"events": [
"organization",
"user"
],
"config": {
"url": "https://example.com",
"content_type": "json",
"insecure_ssl": "0",
"secret": "********"
},
"updated_at": "2017-12-07T00:14:59Z",
"created_at": "2017-12-07T00:14:59Z",
"url": "https://HOSTNAME/admin/hooks/1",
"ping_url": "https://HOSTNAME/admin/hooks/1/pings"
}
Update a global webhook
Parameters that are not provided will be overwritten with the default value or removed if no default exists.
"Update a global webhook" のパラメーター
ヘッダー | ||||||||
---|---|---|---|---|---|---|---|---|
名前, Type, 説明 | ||||||||
accept string Setting to | ||||||||
パス パラメーター | ||||||||
名前, Type, 説明 | ||||||||
hook_id integer 必須The unique identifier of the hook. | ||||||||
本文のパラメーター | ||||||||
名前, Type, 説明 | ||||||||
config object Key/value pairs to provide settings for this webhook. | ||||||||
Properties of |
名前, Type, 説明 |
---|
url string 必須The URL to which the payloads will be delivered. |
content_type string The media type used to serialize the payloads. Supported values include |
secret string If provided, the |
insecure_ssl string Determines whether the SSL certificate of the host for |
events
array of strings The events that trigger this webhook. A global webhook can be triggered by user
and organization
events. Default: user
and organization
.
active
boolean Determines if notifications are sent when the webhook is triggered. Set to true
to send notifications.
Default: true
"Update a global webhook" の HTTP 応答状態コード
状態コード | 説明 |
---|---|
200 | OK |
"Update a global webhook" のコード サンプル
curl -L \
-X PATCH \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/admin/hooks/HOOK_ID \
-d '{"events":["organization"],"config":{"url":"https://example.com/webhook"}}'
Response
Status: 200
{
"type": "Global",
"id": 1,
"name": "web",
"active": true,
"events": [
"organization"
],
"config": {
"url": "https://example.com",
"content_type": "form",
"insecure_ssl": "0"
},
"updated_at": "2017-12-07T00:14:59Z",
"created_at": "2017-12-07T00:14:59Z",
"url": "https://HOSTNAME/admin/hooks/1",
"ping_url": "https://HOSTNAME/admin/hooks/1/pings"
}
Delete a global webhook
"Delete a global webhook" のパラメーター
ヘッダー |
---|
名前, Type, 説明 |
accept string Setting to |
パス パラメーター |
名前, Type, 説明 |
hook_id integer 必須The unique identifier of the hook. |
"Delete a global webhook" の HTTP 応答状態コード
状態コード | 説明 |
---|---|
204 | No Content |
"Delete a global webhook" のコード サンプル
curl -L \
-X DELETE \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/admin/hooks/HOOK_ID
Response
Status: 204
Ping a global webhook
This will trigger a ping event to be sent to the webhook.
"Ping a global webhook" のパラメーター
ヘッダー |
---|
名前, Type, 説明 |
accept string Setting to |
パス パラメーター |
名前, Type, 説明 |
hook_id integer 必須The unique identifier of the hook. |
"Ping a global webhook" の HTTP 応答状態コード
状態コード | 説明 |
---|---|
204 | No Content |
"Ping a global webhook" のコード サンプル
curl -L \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/admin/hooks/HOOK_ID/pings
Response
Status: 204