REST API и язь много-ко-многим

Question

[pixxxel]

Делаю REST API для интернет-магазина.

GET /products или /products/id
возвращает список товаров или отдельный товар

GET /categories или /categories/id
возвращает категории или отдельную категорию товара

В магазине товар и категория товара связаны много-ко многим, то есть у одного товара может быть несколько категорий, или даже не быть ни одной.

Как грамотно организовать это в API?

Answer 1

[egorinsk]

Мне кажется, надо не усложнять API и возвращать категории товара (их id и название например) вместе с товаром, по ссылке /products/id. А если есть реальная потребность получать какие-то свойства товара отдельно (только цена и описание например), добавьте параметр ?fields=field1,field2

Проектировать API стоит не из каких-то абстрактных соображений, а из планируемых сценариев использования, и из соображений простоты.

Answer 2

[Анатолий]

раз уж начали так, то так и продлжайте:
GET /product_categories/id
GET /category_prodycts/id
Апи не обязательно должно быть грамотное, в первую очередь оно должно быть похожим (см функции пхп, все ведь привыкли к беспорядочному набору, и это уже даже не напрягает, но за параметрами каждой функции большинство лезет в доки или пользуется подсказками, этого не выучить никому)

Comments

[pixxxel]

Тогда почему бы не /products/id/categories и /categories/id/products, и главное — что возвращать на этот запрос? Только данные связки (product_id, category_id), или массив полноценных объектов?

[pixxxel]

Если массив объектов, то в случае /products/5/categories — возвращать массив категорий, или объект товара, в котором одно из полей — массив объектов категорий?

[Анатолий]

Посмотрите как это сделано на других рессурсах (твиттер, фейсбук, контакт, ласт.фм и подобные) вообще обычно возвращают полное инфо, либо дают параметр для полного инфо.