Comments 2
В общем статья сводится к: чтобы получить согласованное АПИ его надо генерировать автоматически. Поэтому берём тул токовой генерит АяПИ из кода нашего бэк кеда и будет счастье. Так не бывает.
чтобы все работало АПИ надо писать отдельно желательно на чем-то удобном. Оттуда уже генерировать все что вам надо для бэк и фронт енда.
Создать согласованный АПИ используя code-first подход невозможно принципе.
Так что берём редактор в руки и пишем протокол взаимодействия на высокоуровневом декларативном языке. Чем более декларативный тем лучше. В этом отношении Open API не самый лучший выбор так как json схемы не предназначены для чтения людьми.
Проще уж создать его в виде скажем SQLite базы данных, каждая таблица - тип передаваемых данных, а оттуда генерировать схемы.
SQL читать гораздо проще чем всякие json схемы. Ну и комментариев можно написать сколько угодно. потом заодно можно в тестировании использовать- наполнил базу фейковыми данными и отдавал на каждый тестовый запрос.
Ситуация образная
На прошлой неделе только вот столкнулся с подобным, решили на бэке все поля в snake_case переименовать, а сказать об это забыли 😁
Согласованность API по принципу единого источника истины