5.6. 使用带有 Pagination Control 的搜索

您可以使用 per_page 和 page 分页参数来限制 API 搜索查询返回的搜索结果。per_page 参数指定每个页面的结果数，page 参数指定按 per_page 参数计算的页面，以便返回。

当您不指定任何分页参数时，要返回的默认项数量被设置为 1000，但 per_page 值的默认值为 20，在指定 page 参数时应用默认值。

列出内容视图

本例在页面中返回一个 Content Views 列表。列表中每个页面包含 10 个键并返回第三个页面。

请求示例： 

$ curl --request GET --user sat_username:sat_password \
https://satellite.example.com/katello/api/content_views?per_page=10&page=3

列出激活码

这个示例返回带有 ID 1 在页中的机构的激活码列表。列表中每个页面包含 30 个密钥，并返回第二页。

请求示例： 

$ curl --request GET --user sat_username:sat_password \
https://satellite.example.com/katello/api/activation_keys?organization_id=1&per_page=30&page=2

返回多个页面

您可以使用 for 循环结构获取多个结果页面。

这个示例将页面 1 返回为 3 个内容视图，每个页面有 5 个结果： 

$ for i in seq 1 3; do \
curl --request GET --user sat_username:sat_password \
https://satellite.example.com/katello/api/content_views?per_page=5&page=$i; \
done