News for hackers. Stuff that matters.
Re:Swagger is now the OpenAPI Specification by Arnavion on Monday October 23, 2017 @04:41PM (#15536774)
>So, I don't get the hate for SOAP/WSDL.

AFAIK one of the sources of hatred for SOAP is people building the message bodies by hand using browser JS instead of using a code generator (one might not have existed for browser JS at that time). Not only was it complicated by being XML, but SOAP bodies are especially verbose XML.

Re:Swagger is now the OpenAPI Specification by jbergstroem on Monday October 23, 2017 @04:47PM (#15536808)
It's usually extra hostile for things like caching. I've (on multiple occasions) seen one URI endpoint, http posts and method as a separate header. Pretty much as far away from a sane caching best practice as you can go. Also; a lot of these older web services doesn't support deflate, gzip (accept-encoding, vary, ..) so your average responses are 500kb and up. :'(

In a recent project, a client saturated their wire as a result of just this.

Re:Swagger is now the OpenAPI Specification by ivanhoe on Monday October 23, 2017 @08:26PM (#15538172)
My main frustration with soap services is that when it works it's great, but when something is wrong and you don't control the server side it's really frustrating to figure out what's wrong. Too often wsdl descriptions for 3rd party apis are desperately out of date, and debugging api call by looking at xml with auto-generated type definitions is hell. SOAP is just not human-friendly enough, it's too complex. In the end the most popular formats always end up being the ones that are easiest for humans to process & debug: plain text commands in telnet/pop3/smpt, html, json, restful calls, etc.
Re:Swagger is now the OpenAPI Specification by dreamfactored on Monday October 23, 2017 @04:46PM (#15536801)
lack of cacheability is the main issue I've heard