Files
upstream-ory-kratos/oryx/pagination/migrationpagination/header.go
upstream-mirror c60cc7ca75
Some checks failed
CI / Run tests and lints (push) Failing after 29s
CI / Build CLI docs (push) Has been skipped
CI / Run Playwright end-to-end tests (mysql) (push) Failing after 3s
CI / Run Playwright end-to-end tests (postgres) (push) Failing after 2s
CI / Run Playwright end-to-end tests (sqlite) (push) Failing after 3s
CodeQL / Analyze (go) (push) Failing after 4s
CodeQL / Analyze (javascript) (push) Failing after 3s
Docker Image Scanners / scanners (push) Failing after 4s
Synchronize Issue Labels / Synchronize Issue Labels (push) Has been skipped
CI / Run end-to-end tests (postgres) (push) Failing after 19s
CI / Run end-to-end tests (sqlite) (push) Failing after 2s
CI / Run Playwright end-to-end tests (cockroach) (push) Failing after 2s
CI / Draft newsletter (push) Has been skipped
CI / Generate release (push) Has been skipped
CI / Pending approval Slack notification (push) Has been skipped
CI / Send newsletter (push) Has been skipped
snapshot of https://github.com/ory/kratos.git (master, 2026-09-15; blobs > 131072B omitted)
2026-09-15 21:19:12 +05:00

91 lines
3.1 KiB
Go

// Copyright © 2023 Ory Corp
// SPDX-License-Identifier: Apache-2.0
package migrationpagination
// swagger:model mixedPaginationRequestParameters
type RequestParameters struct {
// Deprecated Items per Page
//
// DEPRECATED: Please use `page_token` instead. This parameter will be removed in the future.
//
// This is the number of items per page.
//
// required: false
// in: query
// default: 250
// min: 1
// max: 1000
PerPage int `json:"per_page"`
// Deprecated Pagination Page
//
// DEPRECATED: Please use `page_token` instead. This parameter will be removed in the future.
//
// This value is currently an integer, but it is not sequential. The value is not the page number, but a
// reference. The next page can be any number and some numbers might return an empty list.
//
// For example, page 2 might not follow after page 1. And even if page 3 and 5 exist, but page 4 might not exist.
// The first page can be retrieved by omitting this parameter. Following page pointers will be returned in the
// `Link` header.
//
// required: false
// in: query
Page int `json:"page"`
// Page Size
//
// This is the number of items per page to return. For details on pagination please head over to the
// [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).
//
// required: false
// in: query
// default: 250
// min: 1
// max: 500
PageSize int `json:"page_size"`
// Next Page Token
//
// The next page token. For details on pagination please head over to the
// [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).
//
// required: false
// in: query
PageToken string `json:"page_token"`
}
// Pagination Response Header
//
// The `Link` HTTP header contains multiple links (`first`, `next`, `last`, `previous`) formatted as:
// `<https://{project-slug}.projects.oryapis.com/admin/clients?page_size={limit}&page_token={offset}>; rel="{page}"`
//
// For details on pagination please head over to the [pagination documentation](https://www.ory.com/docs/ecosystem/api-design#pagination).
//
// swagger:model mixedPagePaginationResponseHeaders
type ResponseHeaderAnnotation struct {
// The Link HTTP Header
//
// The `Link` header contains a comma-delimited list of links to the following pages:
//
// - first: The first page of results.
// - next: The next page of results.
// - prev: The previous page of results.
// - last: The last page of results.
//
// Pages are omitted if they do not exist. For example, if there is no next page, the `next` link is omitted.
//
// The header value may look like follows:
//
// </clients?limit=5&offset=0>; rel="first",</clients?limit=5&offset=15>; rel="next",</clients?limit=5&offset=5>; rel="prev",</clients?limit=5&offset=20>; rel="last"
Link string `json:"link"`
// The X-Total-Count HTTP Header
//
// The `X-Total-Count` header contains the total number of items in the collection.
//
// DEPRECATED: This header will be removed eventually. Please use the `Link` header
// instead to check whether you are on the last page.
TotalCount int `json:"x-total-count"`
}