@kkk1337 Pracowałem z XML RPC, Corba+IDL, WSDL, WADL, Thrift, Swagger v2, Open API oraz Protobuf/GRPC. Z tego całego zestawu poza martwym Corba+IDL oraz WADL najgorzej wypada Swagger v2 oraz OAS. Wszystko przez to że generatory kodu, z openapi-generator na czele, wypluwają z siebie albo za dużo, albo za mało albo w sposób niezdatny do użytku. Mówię tu o ekosystemie JVM, który odbiega od Go i części mobilków.
To, że można stworzyć na OAS działający deskryptor nie znaczy, że generator go dobrze obsłuży. Zacznę od tego, że json i yaml to są fajne formaty wymiany danych czy pisania niewielkiej konfiguracji, które mają bardzo luźną i trudną do walidacji składnię. Rozjazd implementacyjny tego jak obsłuży to generator klienta a jak generator serwera w porównaniu do XML Schemy, IDL, Thrift czy Protobuf jest poza ludzkim pojęciem.