title: Swagger documentation for Spring Pageable interface
body: <p>I have developed a microservice using Spring Boot. The documentation for the REST API is made with Swagger. Some REST resources make use of Spring concepts to provide pagination for free. Below is an example:</p>
  
  <pre><code>@RequestMapping(value = "/buckets", method = GET)
  public PagedResources list(Pageable pageable, PagedResourcesAssembler assembler) {
      return bucketService.listBuckets(pageable, assembler);
  }
  </code></pre>
  
  <p>If I open the Swagger page, the following form is available for the resource:</p>
  
  <p><a href="https://i.stack.imgur.com/9Idn4.png" rel="noreferrer"><img src="https://i.stack.imgur.com/9Idn4.png" alt="enter image description here"></a></p>
  
  <p>The issue I have is that the pageable parameter is detected with content-type <em>application/json</em> and I don't know how to pass a value to change the page size for example. All values seem to be ignored.</p>
  
  <p>Is it possible to pass the query parameters as JSON object? or is it possible to configure Swagger to generate independent query parameter fields for getters contained by the Pageable interface? </p>
  
  <p>Please note that I am using Springfox with Gradle:</p>
  
  <pre><code>compile 'io.springfox:springfox-spring-web:2.3.1'
  compile 'io.springfox:springfox-swagger2:2.3.1'
  compile 'io.springfox:springfox-swagger-ui:2.3.1'
  </code></pre>