Jest w niej cała masa nieaktualnych rzeczy i duplikatów.
Przykładowe walidowanie w postmanie pokazuje że jest nie tak jak powinno być.
#api #programowanie #hejto
@kkk1337 spróbowałem z tego wygenerować klienta przez https://github.com/deepmap/oapi-codegen ale wyszedł giga syf. Podejrzałem też requesty (obstawiam, że tak robił @dev) ale dzisiaj już wymagają odpalenia JSa i obsługiwania cookies, a zabawa w obchodzenie cloudfronta to już trochę ponad hobbistyczne zasoby mojego czasu.
@wombatDaiquiri ja chciałem zwyczajnie zacząć prace nad botem ale takim użytecznym, tylko ze te definicje open api są skopane. Nie chciałem robić żadnego syfu
@wombatDaiquiri śmietnik na wyjściu jest gwarantowany przez openapi samo przez się.
@splatch No raczej nie, chyba nigdy nie pracowałeś z Open API
@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.
Zaloguj się aby komentować