News for hackers. Stuff that matters.
Re:Ask HN: Do you use automated tools to create APIs, or do ... by escanda on Monday June 24, 2019 @10:43AM (#20263996)
Nobody remembers anymore SOAP it seems haha It's funny but all those new documentation and code generators for Rest were largely invented in SOAP messages before.

It doesn't make sense to send SOAP messages to browsers but I cringe every time I find myself with a vaguely documented Rest API when integrating systems.

Re:Ask HN: Do you use automated tools to create APIs, or do ... by hacker_123 on Monday June 24, 2019 @01:27PM (#20266019)
I similarly cringe at vaguely documented APIs, but being a young developer, my experience with REST has been better. For instance, I've consumed a SOAP API where the WSDL specification was primarily a method named "Magic" that accepted a string "Method" and six string-typed parameters, "Parameter1" through "Parameter6".

I think the key is to pick a documentation tool that the team will actually use.