Swagger - REST

14 views
Skip to first unread message

Kalman Bekesi

unread,
Nov 23, 2012, 1:41:17 AM11/23/12
to illegal...@googlegroups.com
I know how much you guys like talking about REST, have you come across http://swagger.wordnik.com/ - thoughts?

Kal

Mark Derricutt

unread,
Nov 23, 2012, 3:22:59 AM11/23/12
to illegal...@googlegroups.com
I may like to talk REST but I'm sure you'll get crazed rabbid responses from Greg on that ;-)

I looked at Swagger awhile ago and really liked what it offers - a very nice clean UI for documenting an API. What I also really liked was the ability to "test the API" and see what came back.

I've not yet actually USED it tho but definitely looks like something to watch. I like that it also has a spec for being a standard way of describing an API.

Michael Neale

unread,
Nov 25, 2012, 12:07:49 AM11/25/12
to illegal...@googlegroups.com
REST needs to die. 

We need CURL-friendly(tm) apis.

** Note - I will never define curl apis are - only that you are doing it wrong, and that makes me angry. 

Mark Derricutt

unread,
Nov 25, 2012, 12:10:41 AM11/25/12
to illegal...@googlegroups.com
REST doesn't necessarily mean curl unfriendly. As long as you're POST/PUTing form encoded things at least, submitting XML/JSON starts getting painful.

The question is tho - WHY do we need CURL friendly APIs? Most people don't even know what curl is.

Greg Amer

unread,
Nov 25, 2012, 3:34:41 AM11/25/12
to illegal...@googlegroups.com
The a pig ee guys reckon that you need browser friendly api as most of your api users will come from the land of the long broken browser and won't understand things like curl, so unless your api is easily usable from the browser it's an uphill battle from the start

Kerry Sainsbury

unread,
Nov 25, 2012, 2:27:13 PM11/25/12
to illegal...@googlegroups.com
OK Gerg, I'll bite:

wtf is "a pig ee"?

(Google didn't help)

Thanks!

Mark Derricutt

unread,
Nov 25, 2012, 2:38:54 PM11/25/12
to illegal...@googlegroups.com


As mentioned on the last podcast.  Apigee do a lot of pragmatic restful stuff.

The odd thing in all Greg's REST-hate is I've yet to see him offer a viable alternate solution - other than just PHP whack it.

Michael Neale

unread,
Dec 2, 2012, 12:55:30 AM12/2/12
to illegal...@googlegroups.com
yes I was thinking curl is a most-ly subset of REST, and easier to understand/apply for programmers (not end users, that is another problem). 

It just seems a simple "razor" to apply "could I drive this with curl" - this also includes doing a GET or hitting up URLs to see what is available (so you can discover apis). 

Maybe REST is like good beer - hard to define in writing, but you know it when you have it.
Reply all
Reply to author
Forward
0 new messages