Второй момент: В хорошо спроектированном REST API нет глаголов! Есть HTTP GET, POST, PUT, DELETE и на этом точка!

Другими словами: Не следует писать generageNewOrder, makeNewTicket . Вместо этого надо так:

HTTP PUT order/
HTTP PUT ticket/

Если ты шлешь PUT, POST на сущность, значит ты ее создаешь или обновляешь и различные generate, make избыточны

Третий момент :
Должно быть однообразный результат в HTTP GET

Если вы сделаете HTTP GET /tickets/250
То результат должен быть точно таким же каким он есть во множестве после HTTP GET /tickets

Пример:
HTTP GET /tickets/250 возвращает:
{ "id": 250, "type": "cinema", "price": 130}

HTTP GET /tickets  возвращает:

{  "id": 249, "type": "cinema", "price": 150, "building": "ДК Иванова"},
{ "id": 250,  "type": "cinema", "price": 130, "building": "ДК Горбунова"}

Это не однобразно! По той причине Что в полной выдаче есть еще одно доп.поле "building" .

Не думаю что он поймет.

😁

странный пример, обычно больше полей именно в запросе конкретной сущности

Четвертый момент:
В ответах всегда используются ПОЛНЫЕ ссылки, а не endpoint.

К примеру:
HTTP GET /watches/15

{ "id" 15, url: "/watch/15/details" } - это неправильно

Правильно так:
{ "id" 15, url: "http://www.com/yourserice.com/watch/15/details" }

Почему не должно быть однообразно? Логичнее же когда на детальной странице больше инфы чем в обобщенной

откуда ты копируешь это всё?)

Ну, а я вот хочу, чтоб у велосипедов было 15 колес и называть при этом по прежнему велосипедом!

😂😂😂

Английский знаете? Почти ВСЯ англоязычная литература, в том числе Stackoverflow и различные REST API хоть от гугла и других в той или иной мере следуют этим правилам.

Если этого не наблюдается, то это не REST , а просто WEB API.

У Станка есть и русский отдел 😁

А ему нужно написать Rest API ?)

Ему бы понять, как с ним взаимодействовать

А тут какие-то индивидуальные кейсы

не, ну ок, дело ваше. Я же не настаиваю. Но крайне сомнительная затея использовать русскоязычные источники. Хочет человек читать русские источники, это дело его ))) Это крайне убого

Огромное количество русскоязычных источников это переведенные англоязычные статьи 🌚

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

Вопрос актуальности

Какой актуальности? Если статья на английском старая, то и русская такая же будет.