Add paging headers

[TheFox0x7]

Adds support for paging in admin/hooks api endpoint

fixes: #36516

[TheFox0x7]

Webhooks could probably be unified but I figured it's better to keep this focused. They are also in an awkward spot as they lack paging in webui so I don't think I can just add pagination for functions that are used by web routes without looking at UI.

[silverwind]

test failure looks related:

--- FAIL: TestGetSystemOrDefaultWebhooks (0.01s)
    webhook_system_test.go:20: 
        	Error Trace:	/home/runner/work/gitea/gitea/models/webhook/webhook_system_test.go:20
        	Error:      	"[0xc0000f1200 0xc0000f12c0 0xc0000f1380 0xc0000f1440 0xc0000f1500 0xc0000f15c0]" should have 2 item(s), but has 6
        	Test:       	TestGetSystemOrDefaultWebhooks

[Copilot]

Pull request overview

This PR standardizes API pagination behavior across multiple endpoints, adding Link and X-Total-Count headers where appropriate and introducing proper paging for the admin webhooks endpoint, while also refactoring the system/default webhook query model.

Changes:

• Centralizes pagination through utils.GetListOptions, clamping pages to a minimum of 1 and wiring ctx.SetLinkHeader and SetTotalCountHeader into numerous user, org, repo, shared, and notification endpoints.
• Refactors system/default webhook listing to a new ListSystemWebhookOptions + GetGlobalWebhooks model and updates the admin /admin/hooks endpoint to be fully paginated and to emit paging headers.
• Adds or adjusts pagination headers for specific resource listings (teams, org members, wiki pages, actions runs/jobs/tasks, secrets/variables, notifications, issue dependencies, etc.).

Reviewed changes

Copilot reviewed 21 out of 21 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
routers/api/v1/utils/page.go	Ensures GetListOptions always uses at least page 1 and a normalized page size for all consumers.
routers/api/v1/utils/hook.go	Makes owner hook listing use ListOptions and emit Link/X-Total-Count headers.
routers/api/v1/user/watch.go	Uses shared ListOptions and adds Link/X-Total-Count for watched-repos endpoints.
routers/api/v1/user/star.go	Adds Link headers for starred-repo listings using the user’s star count and current limit.
routers/api/v1/user/key.go	Adds pagination support and headers for user public key listings; introduces a bug when filtering by fingerprint.
routers/api/v1/user/follower.go	Wires in ListOptions and Link headers for followers and following lists.
routers/api/v1/user/action.go	Paginates user-level actions variables and adds Link/X-Total-Count headers.
routers/api/v1/shared/block.go	Uses ListOptions and emits pagination headers for user block listings.
routers/api/v1/shared/action.go	Adds paging and Link/X-Total-Count headers to shared actions jobs and runs listings.
routers/api/v1/repo/wiki.go	Adds pagination headers for wiki page list; adds a FIXME noting missing SetLinkHeader for revisions.
routers/api/v1/repo/status.go	Paginates combined commit status-by-ref and adds corresponding pagination headers.
routers/api/v1/repo/issue_dependency.go	Switches dependency listing to ListOptions and adds pagination headers, but currently uses the page size as the reported total.
routers/api/v1/repo/action.go	Adds paging + Link headers for repo actions secrets, variables, and tasks.
routers/api/v1/org/team.go	Makes org/team and user/team listings use ListOptions and emit Link/X-Total-Count, addressing the linked pagination issue.
routers/api/v1/org/member.go	Paginates org member listing and adds Link/X-Total-Count headers.
routers/api/v1/org/action.go	Adds pagination headers for org-level actions secrets and variables.
routers/api/v1/notify/user.go	Adds Link headers alongside existing total-count logic for notification lists.
routers/api/v1/notify/repo.go	Adds Link headers for repo-scoped notifications.
routers/api/v1/admin/hooks.go	Refactors admin hooks listing to use GetGlobalWebhooks with ListOptions and emit pagination headers.
models/webhook/webhook_system.go	Introduces ListSystemWebhookOptions and GetGlobalWebhooks to support paginated global webhook queries.
models/webhook/webhook_system_test.go	Updates tests to cover GetGlobalWebhooks/ListSystemWebhookOptions while retaining an outdated test name.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.