Источник: Nuances of Programming 1. Знакомство с REST Термин REST API расшифровывается как Representational State Transfer Application Programming Interface. Следовательно, RESTful API  —  это программный интерфейс приложения, соответствующий ограничениям архитектурного стиля REST. REST  —  не протокол и не стандарт. Это, как уже было сказано, архитектурное ограничение. Чтобы API считался RESTful, он должен соответствовать следующим критериям. Благодаря вышеперечисленным архитектурным правилам REST API масштабируемый, переносимый и гибкий...

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