Лучший способ структурирования REST URI

Question

Предположим, у нас есть следующие классы и мы хотим определить REST URI:

class Profile{
   IList<Upload> Uploads{get;}
}

class Upload{
  int ProfileId;
  int CategoryId;
}

class Category{
  IList<Upload> Uploads{get;}
}

Мы можем определить две модели URI:

1. / профили / {ID} / * 1007 загрузки *
2. / категории / {ID} / добавления

Мой первый вопрос - добавить новую загрузку, какая из них предпочтительнее? и второе: каковы лучшие практики проектирования URI?

Answer 1

Если вы делаете одно и то же в двух конечных точках, тогда у вас есть проблема с дизайном.

Я бы посоветовал вам сначала решить, для какой основной функции предназначена загрузка. Это загрузка профиля или категории.

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

Вы можете указать categoryId в качестве параметра запроса для конечной точки загрузки своего профиля, например:

/profiles/{profileid}/uploads?categoryId={categoryid}