github-starred/gitea
2
0
Fork 0
mirror of https://github.com/go-gitea/gitea.git synced 2026-03-12 18:48:08 -05:00
Code Issues 2.6k Packages Projects Releases 100 Wiki Activity

Consistent API default paginations #11071

New Issue
Open
opened 2025-11-02 09:26:47 -06:00 by GiteaMirror · 1 comment
GiteaMirror commented 2025-11-02 09:26:47 -06:00
Owner
Copy Link

Originally created by @lunny on GitHub (Jun 21, 2023).

related #21158

To make all the List APIs have consistent pagination default behaviors, some APIs maybe break. Below is the current behavior:

  • /repos/<owner>/<repo>/issues : page = 0 means page = 1
  • /repos/<owner>/<repo>/labels : page = 0 means get all data
  • /repos/<owner>/<repo>/milestones : page = 0 means get all data
  • /repos/<owner>/<repo>/releases : page = 0 means page = 1
  • /repos/<owner>/<repo>/notifications: page = 0 means get all data
  • /repos/<owner>/<repo>/branches: page = 0 means page = 1
  • /repos/<owner>/<repo>/branches: page = 0 means get all data
  • /repos/<owner>/<repo>/hooks: page = 0 means get all data
  • /repos/<owner>/<repo>/collaborators: page = 0 means get all data
  • /repos/<owner>/<repo>/forks: page = 0 means get all data
  • /repos/<owner>/<repo>/keys: page = 0 means get all data
  • /repos/<owner>/<repo>/times: page = 0 means get all data
  • /repos/<owner>/<repo>/stargazers: page = 0 means get all data
  • /repos/<owner>/<repo>/subscribers: page = 0 means get all data
  • /repos/<owner>/<repo>/push_mirrors: page = 0 means get all data
  • /repos/<owner>/<repo>/commits: page = 0 means page = 1
  • /repos/<owner>/<repo>/pulls: page = 0 means page = 1
Originally created by @lunny on GitHub (Jun 21, 2023). related #21158 To make all the List APIs have consistent pagination default behaviors, some APIs maybe break. Below is the current behavior: - [ ] `/repos/<owner>/<repo>/issues` : `page = 0` means `page = 1` - [ ] `/repos/<owner>/<repo>/labels` : `page = 0` means get all data - [ ] `/repos/<owner>/<repo>/milestones` : `page = 0` means get all data - [ ] `/repos/<owner>/<repo>/releases` : `page = 0` means `page = 1` - [ ] `/repos/<owner>/<repo>/notifications`: `page = 0` means get all data - [ ] `/repos/<owner>/<repo>/branches`: `page = 0` means `page = 1` - [ ] `/repos/<owner>/<repo>/branches`: `page = 0` means get all data - [ ] `/repos/<owner>/<repo>/hooks`: `page = 0` means get all data - [ ] `/repos/<owner>/<repo>/collaborators`: `page = 0` means get all data - [ ] `/repos/<owner>/<repo>/forks`: `page = 0` means get all data - [ ] `/repos/<owner>/<repo>/keys`: `page = 0` means get all data - [ ] `/repos/<owner>/<repo>/times`: `page = 0` means get all data - [ ] `/repos/<owner>/<repo>/stargazers`: `page = 0` means get all data - [ ] `/repos/<owner>/<repo>/subscribers`: `page = 0` means get all data - [ ] `/repos/<owner>/<repo>/push_mirrors`: `page = 0` means get all data - [ ] `/repos/<owner>/<repo>/commits`: `page = 0` means `page = 1` - [ ] `/repos/<owner>/<repo>/pulls`: `page = 0` means `page = 1`
GiteaMirror added the topic/apitype/proposal labels 2025-11-02 09:26:47 -06:00
GiteaMirror commented 2025-11-02 09:26:48 -06:00
Author
Owner
Copy Link

@silverwind commented on GitHub (Jun 22, 2023):

page = 0 seems kind of pointless because if there is no limit parameter, it should have the same effect of retrieving all items. Of course it may still need to be supported in case existing clients rely on this quirk.

@silverwind commented on GitHub (Jun 22, 2023): `page = 0` seems kind of pointless because if there is no `limit` parameter, it should have the same effect of retrieving all items. Of course it may still need to be supported in case existing clients rely on this quirk.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
$20
$250
$50
$500
backport/done
💎 Bounty
docs-update-needed
good first issue
hacktoberfest
issue/bounty
issue/confirmed
issue/critical
issue/duplicate
issue/needs-feedback
issue/not-a-bug
issue/regression
issue/stale
issue/workaround
lgtm/need 2
modifies/api
modifies/translation
outdated/backport/v1.18
outdated/theme/markdown
outdated/theme/timetracker
performance/bigrepo
performance/cpu
performance/memory
performance/speed
pr/breaking
proposal/accepted
proposal/rejected
pr/wip
pull-request
Mirrored from GitHub Pull Request
 reviewed/wontfix
💰 Rewarded
skip-changelog
status/blocked
topic/accessibility
topic/api
topic/authentication
topic/build
topic/code-linting
topic/commit-signing
topic/content-rendering
topic/deployment
topic/distribution
topic/federation
topic/gitea-actions
topic/issues
topic/lfs
topic/mobile
topic/moderation
topic/packages
topic/pr
topic/projects
topic/repo
topic/repo-migration
topic/security
topic/theme
topic/ui
topic/ui-interaction
topic/ux
topic/webhooks
topic/wiki
type/bug
type/deprecation
type/docs
type/enhancement
type/feature
type/miscellaneous
type/proposal
type/question
type/refactoring
type/summary
type/testing
type/upstream
No Label topic/api type/proposal
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
GiteaMirror ninjasurge
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/gitea#11071
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?