Привет! Подскажите пожалуйста авторитетный источник, в котором описывается как правильно

Question

Привет! Подскажите пожалуйста авторитетный источник, в котором описывается как правильно

строить пути в REST. Особенно хорошо, если будут и примеры плохого API дизайна.
Если конкретно, есть апи в котором в средине пути идет список элементов разделенных запятыми. На мой взгляд, это очевдино плохой дизайн, но мне надо обосновать.
Во-первых, один и тот же ресурс может адресоваться разными путями в зависимости от сортировки списка. Во-вторых, если это GET, то будут проблемы с кешированием. В-третьих, если нам понадобится сравнивать пути это может превратиться в адище. В-четвертых, и это на мой взгляд наибольшая концептуальная проблема, пути должны представлять собой иерархические структуры. Когда в средине пути идет список с трудом можно себе представить что за иерархия подразумевается.
Упустил ли я что-то еще? И по четвертому пункту есть ли где-то развернутый гайдлайн? Похоже, это единственное явно нарушение RFC. В дисере Филдинга по REST на этот счет деталей не нашел. В URI RFC 3986 есть кое-что об иерархической природе путей, но конкретных примеров из разряда "вот это хорошо, а вот это плохо" нет.

#backend #go #programming #russian

0

07.07.2019