Question

I would like to design a RESTful search URI using query parameters. For example, this URI returns a list of all users:

GET /users

And the first 25 users with the last name “Harvey”:

GET /users?surname=Harvey&maxResults=25

How can I use hypermedia to describe what query parameters are allowed by the “/users” resource? I noticed that the new Google Tasks API 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.

Thank you in advance!

Answer 1

Using the syntax described in the current draft of the URI template spec you would do:

/users{?surname,maxresults}