REST API и загрузка загруженных ресурсов

Question

Представьте себе ресурс, такой как авторы. Автор имеет несколько книг, несколько фотографий и т. Д.

На некоторых страницах моего приложения мне нужны только данные авторского права, такие как имя. На других страницах мне нужны все вложенные ресурсы. Как обрабатывать загрузку вложенных ресурсов?

1. ли я загрузить все в одном вызове, что:
   GET/авторы возвращает { имя: х, книги: { BookName: а, ... }}

2. Примите необязательный параметр, который указывает вложенные объекты, например:
   GET/авторы? Include = books & Фотографии

3. Возвращайте только данные об авторских правах, затем извлекайте связанные ресурсы в последующих вызовах. Тем не менее, это может привести к п + 1 запросов типа, такие как:
   GET/авторы
   GET/автора/1/изображений
   GET/автора/1/книги

Любое понимание ценится

Answer 1

Я хотел бы пойти со следующими URL-адресов REST-стиле:

GET/авторы - получить список всех авторов

GET/авторы/{AuthorID} - основная информация о concr ет автор в одном запросе

GET/авторы/{AuthorID}/детализированный - детальная информация о конкретном авторе в одном запросе

Кроме того, вы можете иметь следующие методы для извлечения конкретной информации об авторе:

GET/авторы/{AuthorID}/изображения - получить все изображения от автора

GET/авторы/{AuthorID}/изображений/{ImageID} - получить одно изображение автором

GET/авторы/{AuthorID}/книги - получить все книги автора

GET/авторы/{AuthorID}/книги/{BookID} - получить одну книгу автора

Также рекомендую прочитать соглашения об именах REST ресурсов here.