title: How can I use HATEOAS and Query Parameters for RESTful search?
body: <p>I would like to design a RESTful search URI using query parameters. For example, this URI returns a list of all users:</p>
  
  <blockquote>
    <p>GET /users</p>
  </blockquote>
  
  <p>And the first 25 users with the last name "Harvey":</p>
  
  <blockquote>
    <p>GET /users?surname=Harvey&amp;maxResults=25</p>
  </blockquote>
  
  <p>How can I use hypermedia to describe what query parameters are allowed by the "/users" resource? I noticed that the new <a href="http://code.google.com/apis/tasks/v1/reference.html#method_tasks_tasks_list" rel="noreferrer">Google Tasks API</a> just documents all the query parameters in the reference guide. I will document the list, but I would like to do it with HATEOAS too.</p>
  
  <p>Thank you in advance!</p>