Запросы
В общем предлагается разделить все End-Point`ы на 2 типа:
-
CRUD — операции над объектами системы.
-
Actions — операции которые выполняются в рамках контроллеров, параметры и ответы которых регламентируются отдельно от CRUD.
Версионирование API не предусмотрено, т.к. проект не планирует быть настолько масштабным, что бы это имело смысл. Поэтому все end-point`ы начинаются с <MainUrl>/api/<controller name>
Далее в документации описание будет начинаться с названия контроллера.