Cтепень зрелости REST API
Last updated
Was this helpful?
Last updated
Was this helpful?
В википедии данный уровень зрелости называется болотом оспы, но мне такое название не очень нравится(звучит противно), поэтому добавим немного поэзии и переведем The Swamp of Plain Old XML, как болото Простого Старого Ыксемеля, что сокращенное читается, как ПСЫ, а значит собачье.
Вообще, данный уровень нулевой потому, что систему, данного уровня вообще нельзя классифицировать, как RESTful.
В такой реализации у нас есть один URL, на который поступают все запросы (обычно POST) и система уже по составу запроса решает, что от нее хотят и какой ей дать на это ответ.
Однако, даже для такого спорного уровня зрелости существуют свои правила:
В URL адресах должны использоваться дефисы (-), чтобы улучшить их читаемость. Это значит, что при составлении адресов должен использоваться spinal-case.
Пример:
- хорошо
- плохо
Не должны использоваться нижние подчеркивания (_)
Тут все очевидно – смотрим правило 1
Предпочтительно использовать строчные буквы при составлении URL адресов
Тут тоже все понятно:
- хорошо
- плохо
В URL нельзя включать расширения файлов
Это значит, что когда мы хотим получить какой-либо файл с сервера, то мы не указываем его расширение:
- хорошо
- плохо
Источник:
(новая)