Я не понимаю, какие дополнительные функции /api/ маршруты имеют по сравнению с getStaticProps и getServerSideProps.
Я видел несколько примеров, когда людям нравится делать HTTP GET запросы с помощью getStaticProps и getServerSideProps и использовать /api/ маршрут для PUT PATCH DELETE запросов.
Есть ли какой-либо официальный документ с лучшими практиками о том, что использовать для разных случаев использования?
Вы используете /api/ маршруты из внешнего интерфейса вашего приложения. Это означает, что пока ваше приложение запущено, а страница уже загружена. Допустим, у вас есть страница панели инструментов, и вы пытаетесь отображать всегда свежие данные. В этом случае вы будете постоянно обращаться к своим api маршрутам для получения новых данных.
Также, например, если у вас есть todo приложение, когда пользователь сохраняет новую задачу todo, вы должны отправить запрос api/todo на сохранение задачи в базе данных.
