jojo/routers/api/v1/user
Myers Carpenter 00b457e291 feat: Add header annotations for accurate API documentation (#9380)
This will help api packages like https://codeberg.org/Cyborus/forgejo-api to generate clients that expose the header information as well. Currently `forgejo-api` has to edit the swagger json to generate a client crate that knows about headers.

- Create separate response types for different endpoint behaviors
- CommitList: Base type with only X-Total-Count header
- CommitListWithPagination: For GetPullRequestCommits (pagination headers + X-Total-Count)
- CommitListWithLegacyPagination: For GetAllCommits (pagination headers + X-Total-Count + deprecated X-Total)
- ChangedFileList: Base type with only X-Total-Count header
- ChangedFileListWithPagination: For GetPullRequestFiles (pagination headers + X-Total-Count)

This ensures swagger documentation accurately reflects which headers each endpoint returns.

Reviewed-on: https://codeberg.org/forgejo/forgejo/pulls/9380
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Reviewed-by: Cyborus <cyborus@disroot.org>
Co-authored-by: Myers Carpenter <myers@maski.org>
Co-committed-by: Myers Carpenter <myers@maski.org>
2026-01-06 10:29:15 +01:00
..
action.go chore(lint): Add exceptions for dbfs_model and unittest (#10275) 2025-12-09 14:34:06 +01:00
app.go fix: correct token summary in swagger to specify the used user. (#10367) 2025-12-10 17:13:07 +01:00
avatar.go chore(api): update swagger method descripitons (#8728) 2025-07-30 18:08:28 +02:00
email.go chore(api): update swagger method descripitons (#8728) 2025-07-30 18:08:28 +02:00
follower.go chore: branding import path (#7337) 2025-03-27 19:40:14 +00:00
gpg_key.go Update Swagger annotations to reflect actual behavior (#9138) 2025-09-15 11:55:49 +02:00
helper.go fix: do visibility check for user redirect lookup 2025-08-30 09:37:25 +02:00
hook.go feat: Add header annotations for accurate API documentation (#9380) 2026-01-06 10:29:15 +01:00
key.go chore(cleanup): replaces unnecessary calls to formatting functions by non-formatting equivalents (#7994) 2025-05-29 17:34:29 +02:00
quota.go Update Swagger annotations to reflect actual behavior (#9138) 2025-09-15 11:55:49 +02:00
repo.go Update module github.com/golangci/golangci-lint/cmd/golangci-lint to v2 (forgejo) (#7367) 2025-03-28 22:22:21 +00:00
runners.go feat: add HTTP API endpoint for runner registration (#10677) 2026-01-05 04:59:04 +01:00
settings.go chore(api): update swagger method descripitons (#8728) 2025-07-30 18:08:28 +02:00
star.go chore: branding import path (#7337) 2025-03-27 19:40:14 +00:00
user.go Update Swagger annotations to reflect actual behavior (#9138) 2025-09-15 11:55:49 +02:00
watch.go chore: branding import path (#7337) 2025-03-27 19:40:14 +00:00