<rmcreative>

RSS

Все заметки с тегом «REST»

Можно уточнить:

    (1)
    (1)
    (1)
    (1)
    (1)
  1. (1)
  2. (1)
  1. Сортировка и фильтрация в REST API

    15 августа 2016

    Среди информации по построению REST API встречаются две рекомендации на тему сортировки и фильтрации. Сортировку делать вот так:

    GET /users?sort=-created_at,username
    

    Сортируем по убыванию по дате создания и по имени пользователя в алфавитном порядке.

    Фильтры делать вот так:

    GET /tickets?status=open&assignee=123
    

    Получаем открытые тикеты, назначенные на пользователя с ID=123.

    Вроде всё красиво, но что если у очередного ресурса появится поле sort? GET-параметр уже зарезервирован для сортировки, использовать его для фильтрации не получается. Выхода два: либо заставить пользователя никогда не использовать поле sort (а к нему со временем добавится like и ещё что-нибудь) либо ввести для фильтрации отдельный параметр filter. Значение лучше всего описать в формате JSON: не придётся заботиться о специальных правилах экранирования, да и поддержка его есть во всех клиентах.

    GET /tickets?filter={"status": "open", "assignee": 123}
    

    В случае отдельного параметра, хоть синтаксис и не настолько интуитивен, конфликт имён исключается.

    9 комментариев
  2. Типы HTTP-запросов и философия REST

    25 января 2009

    Краткое описание принципа REST и использования в его контексте методов GET, POST, PUT и DELETE.

    Читаем

    Комментарии тоже довольно полезны.

    Да, кстати. Имеется инвайт на Хабр. Отдам в руки человеку, у которого есть хорошая статья и желание её опубликовать.

    2 комментария
  3. RESTful PHP — 5 простых советов

    3 декабря 2008

    Краткое резюме на тему REST и PHP. Может помочь понять, в чём же вся прелесть REST.

    Читаем

    Комментировать