This chapter contains generally applicable information on API design. When using Ory services, one can expect a consistent experience when interacting with REST APIs.
On REST endpoints that are explicitly labeled as such, pagination information is
available through the
Link HTTP header.
Link header contains a comma-delimited list of links to the following
pages (where applicable):
- Previous (prev)
Pages are created based on the values of
offset provided in the
limit is the page size, and
offset is the current item.
In most scenarios, the
offset should be a multiple of the
> GET hydra-admin/clients?limit=5&offset=10 HTTP/1.1 > Host: localhost:4445 > User-Agent: curl/7.64.1 > Accept: */* > < HTTP/1.1 200 OK < Content-Type: application/json < Link: <hydra-admin/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" < Date: Mon, 22 Apr 2019 23:34:29 GMT < Transfer-Encoding: chunked < [...]