# System hooks API > 原文：[https://docs.gitlab.com/ee/api/system_hooks.html](https://docs.gitlab.com/ee/api/system_hooks.html) * [List system hooks](#list-system-hooks) * [Add new system hook](#add-new-system-hook) * [Test system hook](#test-system-hook) * [Delete system hook](#delete-system-hook) # System hooks API[](#system-hooks-api "Permalink") 所有方法都需要管理員授權. 也可以使用**Admin Area> System Hooks** （ `/admin/hooks` ）中的 UI 來配置系統掛鉤的 URL 端點. 閱讀有關[系統掛鉤的](../system_hooks/system_hooks.html)更多信息. ## List system hooks[](#list-system-hooks "Permalink") 獲取所有系統掛鉤的列表. ``` GET /hooks ``` 請求示例： ``` curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/hooks" ``` 響應示例： ``` [ { "id":1, "url":"https://gitlab.example.com/hook", "created_at":"2016-10-31T12:32:15.192Z", "push_events":true, "tag_push_events":false, "merge_requests_events": true, "repository_update_events": true, "enable_ssl_verification":true } ] ``` ## Add new system hook[](#add-new-system-hook "Permalink") 添加一個新的系統掛鉤. ``` POST /hooks ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `url` | string | yes | 掛鉤網址 | | `token` | string | no | 用于驗證收到的有效載荷的秘密令牌； 這將不會在響應中返回 | | `push_events` | boolean | no | 設置為 true 時，掛鉤將在推送事件時觸發 | | `tag_push_events` | boolean | no | 設置為 true 時，掛鉤將在被推送的新標簽上觸發 | | `merge_requests_events` | boolean | no | 觸發合并請求事件的鉤子 | | `repository_update_events` | boolean | no | 觸發掛鉤存儲庫更新事件 | | `enable_ssl_verification` | boolean | no | 觸發掛鉤時執行 SSL 驗證 | 請求示例： ``` curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/hooks?url=https://gitlab.example.com/hook" ``` 響應示例： ``` [ { "id":1, "url":"https://gitlab.example.com/hook", "created_at":"2016-10-31T12:32:15.192Z", "push_events":true, "tag_push_events":false, "merge_requests_events": true, "repository_update_events": true, "enable_ssl_verification":true } ] ``` ## Test system hook[](#test-system-hook "Permalink") ``` GET /hooks/:id ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer | yes | 鉤子的 ID | 請求示例： ``` curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/hooks/2" ``` 響應示例： ``` { "project_id" : 1, "owner_email" : "example@gitlabhq.com", "owner_name" : "Someone", "name" : "Ruby", "path" : "ruby", "event_name" : "project_create" } ``` ## Delete system hook[](#delete-system-hook "Permalink") 刪除系統掛鉤. ``` DELETE /hooks/:id ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer | yes | 鉤子的 ID | 請求示例： ``` curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/hooks/2" ```