Туда можно что угодно засунуть, даже таблицы внутри вести. Есть в открытые сервисы с шикарной документацией на его основе. Но под такое уже лучше техписа заводить.
Зачем тонна документации - не знаю. Нам хватает сваггера + описание внутренней логики, если она нетривиальна.
хорошо) да, это архитектурная концепция, а концепция по сути есть набор определенных правил и соглашений, то можно сказать, что rest это, извините, архитектурный протокол?)
можно ли сказать, что в SOAP мы делаем запросы в один эндпоинт с указанием процедуры и ее аргументов?) именно правильно ли говорить, что мы "стучимся в эндпоинт"?