3 ms·
Coauthor of openapi.tools here. If y'all have suggestions about things we can do to make the project better, we are all ears!
by rocketpastsix 7y ago
Coauthor of openapi.tools here. If y'all have suggestions about things we can do to make the project better, we are all ears!
- RangerScience 7y agoThis is really cool! The one feature I would have asked for is already in place: authorization - so that's super cool. That said, hmm, what do you feel like OpenAPI learned (so as not to repeat) from the pitfalls of SOAP WSDLs?
- rocketpastsix 7y agoThat is a fascinating question. Mostly because I wasn't around for SOAP. I started my development career kind of with the rise of REST. I've only ever used REST personally, so I couldn't really tell you. Looking up WSDL, I can tell you one thing I've noticed with OpenAPI is that it is both incredibly descriptive, and yet not in the way. I can look at an OpenAPI file, figure out what is going really quickly and get working. With WSDL/XML you have to parse the whole XML schema to really understand what is going on.