Длинные адреса для API — это нормально?

Question

[WebDev]

У меня вложенная структура сущностей: создается страница, для страницы создаются картинки, для каждой картинки создаются ссылки. То есть нужен crud для страницы, картинки и ссылки. Я делаю так:

Route::post('pages/create',  'PageController@create');
Route::post('pages/{page}/delete', 'PageController@delete');
Route::post('pages/{page}/images/create',  'PageController@createImage');
Route::post('pages/{page}/images/{image}/update',  'PageController@updateImage');
Route::post('pages/{page}/images/{image}/delete',  'PageController@deleteImage');
Route::post('pages/{page}/images/{image}/links/create', 'PageController@createLink');
Route::post('pages/{page}/images/{image}/links/{link}/update',  'PageController@updateLink');
Route::post('pages/{page}/images/{image}/links/{link}/delete',  'PageController@deleteLink');

Мне интересно, правильно ли это? Можно было бы делать их короче (не вложенными), но при таком подходе сразу понятно что картинка именно от страницы.

Answer 1

[d-sem]

Можно сократить, если использовать HTTP методы в соответствии с их семантикой.

POST создание новой сущности
PATCH, UPDATE изменение
DELETE удаление

Comments

[WebDev]

Да, вы правы про patch/update/delete. Но как это сократит сам адрес эндпоинта?

[d-sem]

WebDev, как минимум не придется читать его до конца чтобы понять что происходит в эндпоинте.

а так то выбор за вами. вы или делаете такие uri или работаете над такой структурой ответа, чтобы связи были очевидны (указывая линки на родителей и связанные объекты, например).

Answer 2

[Иван Шумов]

Работать будет. Правильно или нет зависит от того хочется реализовать REST или нет. Если REST то все это - дичь и надо прочитать про HTTP verbs: PUT, DELETE хотябы. И вообще про концепцию

Comments

[WebDev]

HTTP verbs: PUT, DELETE

Хорошо. Но это тип запроса изменит, а что на счет длины адреса? Я для редактирования ссылки передаю в адрес айди страницы, айди картинки и айди ссылки. Меня этот момент интересует.

[Иван Шумов]

WebDev, всякие /delete, /update, /create будут не нужны. Очевидно

[Иван Шумов]

WebDev, Для понимание REST и веба в целом надо понимать простую истину http(s)://......./.... это ресурс, а HTTP verb это операция над ресурсом