Что такое хороший дизайн для REST URI в случае нескольких страниц результатов?

Question

Скажем, у меня есть сервис, который я хочу открыть через REST.Запрос к службе может привести к длинному списку результатов, которые возвращаются «страница за страницей», поэтому пользователь должен иметь возможность:

• указать критерий порядка (альфа-сортировка назначения того или другого атрибута)
• укажите значение ключа, из которого нужно получить результаты: «показать мне результаты по букве C на ...»
• укажите номер страницы, с которой нужно начинать получатьрезультаты (т. е. я хочу получить результаты со страницы 3)
• указать максимальное количество результатов на странице

Полагаю, критерий порядка хорошо подходит для параметра строки запроса,поскольку он не принадлежит ресурсу, а является просто предпочтением для его возвращаемого представления.

А как насчет других опций?Звучит ли идея целиком или она пахнет слишком сильно веб-ориентированным происхождением?

В качестве примечания, есть ли у вас какие-либо указатели для хороших общих проектных предложений для сложных запросов с несколькими страницами результатов (например,политики для кэширования результатов на сервере)?

Спасибо.

Answer 1

Из RESTful Web Services Cookbook :

Запрос

GET /book?sortbyDesc=date&limit=5

Ответ

{
"id": 9,
"links": [{
  "href": "/book?sortByDesc=date&limit=5&start=5",
  "rel": "next"}]
}