Вопрос о спецификации API JSON и о том, как правильно выполнить запрос (я использую ruby on rails и json api resources gem, но это общий вопрос в любом случае, я знаю, как его реализовать, Я просто хочу, чтобы следовать правилам JSON API по адресу: http://jsonapi.org/format/)Фильтр JSON API включил ресурсы
Ситуация 1:
- Я хочу, чтобы все полки
- Я хочу, чтобы включить все книги, которые находятся на этих полках
- ГЭТ я должен использовать в этом случае:
www.library.com/shelves?include=books
Ситуация 2:
Я хочу, чтобы все книги, но только книги, которые помечены как непрочитанные
ГЭТ я должен использовать это:
www.library.com/books?filter[unread]=true
Что было бы правильным способом спроектировать запрос на все полки с включенными непрочитанными книгами?
Не могу понять это
www.library.com/shelves?include=books&filter[books.unread]=true
?
www.library.com/shelves?include=unread_books
? < - необходимо указать другой ресурс, книги, которые непрочитаны
www.library.com/shelves?filter[books.unread]=true
?
Каков наилучший способ сделать это?
EDIT
После разговора с моим техническим свинцом и несколькими других программистами, первыми варианты благоприятствуют наиболее в таких случаях
Poeditor принимает массив (который выглядит следующим образом: ["option1", "option2"]) в качестве параметра: https://poeditor.com/api_reference/#export. Таким образом, в вашем случае это может выглядеть как фильтр = ["непрочитанный", "доступный"]. – jereksel
@jereksel извините, но я не вижу, как это относится к ситуации, когда вы хотите отфильтровать включенный ресурс.Я не хочу фильтровать по дополнительным условиям/параметрам в этом случае – beniutek