а в чем проблема с 1м пунктом кроме объема? ну и в openapi вы вполне можете описывать не только restful.
не, я не против сваггера, я очень люблю, потому что можно сгенерить клиент-сервер. базар. но когда у тебя мильон методов в немашиночитаемой документации, написание превращается в ад. это раз.
два, у вк очень специфичный формат апи (очень легаси, с бородатых 2010-х), который не вписывается в рамки restful вообще никак. поэтому это больше медвежья услуга спеку написать, мы попробовали, нифига не вышло(