Я хотел бы создать URI RESTful search с использованием параметров запроса. Например, этот URI возвращает список всех пользователей:
GET/users
И первые 25 пользователей с фамилией "Харви":
GET/users? surname = Harvey & maxResults = 25
Как я могу использовать hypermedia для описания того, какие параметры запроса разрешены ресурсом "/users"? Я заметил, что новый API Google Tasks API просто документирует все параметры запроса в справочном руководстве. Я запишу список, но я тоже хотел бы сделать это с HATEOAS.
Заранее благодарю вас!