@hejto czy api zostanie kiedyś poprawione? Chodzi mi konkretnie o definicję open api.
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
e6e17a70-d998-493a-86b0-a7ca7fbb24ad
wombatDaiquiri

@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.

kkk1337

@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

splatch

@wombatDaiquiri śmietnik na wyjściu jest gwarantowany przez openapi samo przez się.

kkk1337

@splatch No raczej nie, chyba nigdy nie pracowałeś z Open API

splatch

@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ć