mirror of
https://github.com/go-gitea/gitea.git
synced 2025-01-31 09:41:28 +02:00
a90af22003
This PR fixes inconsistencies between system and default webhooks in the Gitea API. (See also #26418) - A system webhook is a webhook that captures events for all repositories. - A default webhook is copied to a new repository when it is created. Before this PR `POST /api/v1/admin/hooks/` creates default webhooks (if not configured otherwise) and `GET /api/v1/admin/hooks/` returns system webhooks. The PR introduces an optional query parameter to `GET /api/v1/admin/hooks/` to enable selecting if either default, system or both kind of webhooks should be retrieved. By default the flag is set to return system webhooks keep current behaviour. ## Examples ### System Webhooks #### Create ``` POST /api/v1/admin/hooks/ { "type": "gitea", "active": false, "branch_filter": "*", "events": [ "create", "..." ], "config": { "url": "http://...", "content_type": "json", "secret": "secret", "is_system_webhook": true // <-- controls hook type } } ``` #### List ``` GET/api/v1/admin/hooks?type=system //type argument is optional here since it's the default ``` #### Others The other relevant endpoints work as expected by referencing the hook by id ``` GET /api/v1/admin/hooks/:id PATCH /api/v1/admin/hooks/:id DELETE /api/v1/admin/hooks/:id ``` ### Default Webhooks #### Create ``` POST /api/v1/admin/hooks/ { "type": "gitea", "active": false, "branch_filter": "*", "events": [ "create", "..." ], "config": { "url": "http://...", "content_type": "json", "secret": "secret", "is_system_webhook": false // optional, as false is the default value } } ``` #### List ``` GET/api/v1/admin/hooks?type=default ``` #### Others The other relevant endpoints work as expected by referencing the hook by id ``` GET /api/v1/admin/hooks/:id PATCH /api/v1/admin/hooks/:id DELETE /api/v1/admin/hooks/:id ``` |
||
|---|---|---|
| .. | ||
| access_token.yml | ||
| access.yml | ||
| action_artifact.yml | ||
| action_run_job.yml | ||
| action_run.yml | ||
| action_runner_token.yml | ||
| action_task_output.yml | ||
| action_task.yml | ||
| action.yml | ||
| attachment.yml | ||
| branch.yml | ||
| collaboration.yml | ||
| comment.yml | ||
| commit_status_index.yml | ||
| commit_status.yml | ||
| deploy_key.yml | ||
| email_address.yml | ||
| external_login_user.yml | ||
| follow.yml | ||
| gpg_key_import.yml | ||
| gpg_key.yml | ||
| hook_task.yml | ||
| issue_assignees.yml | ||
| issue_index.yml | ||
| issue_label.yml | ||
| issue_user.yml | ||
| issue_watch.yml | ||
| issue.yml | ||
| label.yml | ||
| lfs_meta_object.yml | ||
| login_source.yml | ||
| milestone.yml | ||
| mirror.yml | ||
| notice.yml | ||
| notification.yml | ||
| oauth2_application.yml | ||
| oauth2_authorization_code.yml | ||
| oauth2_grant.yml | ||
| org_user.yml | ||
| project_board.yml | ||
| project_issue.yml | ||
| project.yml | ||
| protected_branch.yml | ||
| protected_tag.yml | ||
| public_key.yml | ||
| pull_request.yml | ||
| reaction.yml | ||
| release.yml | ||
| renamed_branch.yml | ||
| repo_archiver.yml | ||
| repo_indexer_status.yml | ||
| repo_license.yml | ||
| repo_redirect.yml | ||
| repo_topic.yml | ||
| repo_transfer.yml | ||
| repo_unit.yml | ||
| repository.yml | ||
| review.yml | ||
| star.yml | ||
| stopwatch.yml | ||
| system_setting.yml | ||
| team_repo.yml | ||
| team_unit.yml | ||
| team_user.yml | ||
| team.yml | ||
| topic.yml | ||
| tracked_time.yml | ||
| two_factor.yml | ||
| user_blocking.yml | ||
| user_open_id.yml | ||
| user_redirect.yml | ||
| user.yml | ||
| watch.yml | ||
| webauthn_credential.yml | ||
| webhook.yml | ||