Pagy pagination for grape API framework.
Add this line to your application's Gemfile:
gem 'grape-pagy'
And then execute:
$ bundle
Or install it yourself as:
$ gem install grape-pagy
class MyApi < Grape::API
# Include helpers in your API.
helpers Grape::Pagy::Helpers
resource :posts do
desc 'Return a list of posts.'
params do
# This will add two optional params: :page and :items.
use :pagy
end
get do
posts = Post.all.order(created_at: :desc)
pagy(posts)
end
end
resource :strings do
desc 'Supports arrays as well as relations.'
params do
# Override defaults by setting Pagy::DEFAULT or by passing options.
use :pagy,
items_param: :per_page, # Accept per_page=N param to limit items.
items: 2, # If per_page param is blank, default to 2.
max_items: 10 # Restrict per_page to maximum 10.
end
get do
words = %w[this is a plain array of words]
pagy(words)
end
end
end
Example request:
curl -si https://localhost:8080/api/posts?page=3&items=5
The response will be paginated and also will include the following headers:
Current-Page: 3
Page-Items: 5
Total-Count: 22
Total-Pages: 5
Link: <https://localhost:8080/api/posts?page=1&items=5>; rel="first", <https://localhost:8080/api/posts?page=4&items=5>; rel="next", <https://localhost:8080/api/posts?page=2&items=5>; rel="prev", <https://localhost:8080/api/posts?page=5&items=5>; rel="last"),
Bug reports and pull requests are welcome on GitHub at https://github.com/bsm/grape-pagy.