Профит в том, что имея (или не имея) серверную реализацию REST API или файл спецификации
OpenAPI (Swagger) вы можете:
-
автоматически генерировать к ней документацию
-
автоматически генерировать клиентский код к этому REST API для множества языков программирования
-
проектировать Api с помощью спецификации, а реализацией на стороне клиента и на стороне сервиса могут заниматься не связанные друг с другом команды разработчиков
Например, вы можете воспользоваться расширением для Visual Studio 2017/2019
Unchase OpenAPI (Swagger) Connected Service для автоматической генерации C# или TypeScript кода для клиента (
статья на medium.com), и C# кода контроллеров для сервера по файлу спецификации.
Фактически, после генерации кода контроллера их можно заполнить тем функционалом, который Вам нужен, а после вызывать методы контроллера из сгенерированного клиента.