API-first розробка: чому контракти важливіші за код
Коли фронтенд і бекенд роблять різні люди, найбільше часу з'їдають розбіжності в очікуваннях. Опис контракту наперед прибирає цю проблему.
Суть підходу
Спочатку описується, які дані передаються й у якому форматі. Потім обидві сторони працюють паралельно за цим описом.
Фронтенд не чекає готового бекенду - він працює із заглушками за узгодженим контрактом.
Що це дає
Паралельна робота замість послідовної, менше переробок, автоматична документація, простіше тестування.
І можливість підключити мобільний застосунок чи Mini App пізніше без переробки серверної частини.
Де це надлишково
Для невеликого сайту, який робить одна людина, формальний опис контракту - зайва бюрократія.
Підхід виправданий від двох виконавців або за наявності кількох клієнтських застосунків.
Коротко
Опис контракту наперед економить час, коли працюють кілька людей або планується кілька клієнтських застосунків.