시스템 훅 API
REST API로 시스템 훅을 설정하고 관리합니다.
히스토리 조직의 시스템 훅이 GitLab 19.6에서 도입 되었습니다. 이 API를 사용하여 시스템 훅 을 관리합니다. 시스템 훅은 그룹 내 모든 프로젝트와 하위 그룹에 영향을 주는 그룹 웹훅 과 단일 프로젝트로 범위가 한정되는 프로젝트 웹훅 과는 다릅니다. 각 시스템 훅은 하나의 조직에 속하며, organization_id 속성이 어느 조직인지 보여 줍니다. 모든 엔드포인트는 현재 조직의 훅에만 작동합니다. 목록에는 현재 조직의 훅만 반환됩니다. 새 훅은 현재 조직에 생성됩니다. 다른 조직의 훅에 대한 요청은 404 Not Found 를 반환합니다. 이러한 요청에는 훅 조회, 업데이트, 삭제, 테스트와 URL 변수 및 사용자 지정 헤더 관리가 포함됩니다. 사전 요구 사항: 관리자 액세스 권한이 있어야 합니다. 인스턴스 관리자가 아닌 조직 관리자는 이 API를 사용할 수 없습니다. 조직 관리자는 영역에서 시스템 훅을 관리할 수 있습니다. 자세한 내용은 조직 관리자로서 시스템 훅 관리 를 참고합니다. 모든 시스템 훅 조회 # 현재 조직의 모든 시스템 훅을 조회합니다. GET /hooks 요청 예시: curl --request GET \ --header "PRIVATE-TOKEN: <your_access_token>" \ --url "https://gitlab.example.com/api/v4/hooks" 응답 예시: [ { "id" : 1 , "url" : "https://gitlab.example.com/hook" , "name" : "Hook name" , "description" : "Hook description" , "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 , "organization_id" : 1 , "alert_status" : "executable" , "disabled_until" : null , "url_variables" : [ ] , "push_events_branch_filter" : "" , "branch_filter_strategy" : "wildcard" , "custom_webhook_template" : "{\"event\":\"{{object_kind}}\"}" , "custom_headers" : [ { "key" : "X-Custom-Header" } ] , "token_present" : false , "signing_token_present" : false } ] 시스템 훅 상세 조회 # 히스토리 name 및 description 속성이 GitLab 17.1에서 도입되었습니다 . token_present 및 signing_token_present 속성이 GitLab 19.0에서 도입되