Swagger: A simple, open standard for describing REST APIs with JSON
swagger.wordnik.com
Swagger: A simple, open standard for describing REST APIs with JSON
1–10 of 26 posts
Re: Swagger: A simple, open standard for describing REST APIs with JSON
#2jschema and jschema-rpc both look much nicer:
Re: Swagger: A simple, open standard for describing REST APIs with JSON
#3I like this, but it's the third time the link has been submitted.
Re: Swagger: A simple, open standard for describing REST APIs with JSON
#4I like the name at least.
Re: Swagger: A simple, open standard for describing REST APIs with JSON
#5jschema and jschema-rpc both look much nicer: http://jschema.org/ http://jschema.org/rpc.html
jsonschema has been around for a long time too.
Re: Swagger: A simple, open standard for describing REST APIs with JSON
#6I vehemently detest this name.
Re: Swagger: A simple, open standard for describing REST APIs with JSON
#7The example demonstrates an RPC-style HTTP API with pretty URLs. There's no hypermedia in sight. Oh well, we'll figure it out one day...
That being said, this is exactly the sort of documentation that's helpful for this kind of API.
Re: Swagger: A simple, open standard for describing REST APIs with JSON
#8I was excited until I saw it was written in Java.
Re: Swagger: A simple, open standard for describing REST APIs with JSON
#9While documentation is good, I still don't get the need for programmatic documentation.
I suppose the desire is to have a service describing itself so proxies can be code gen'd, but I'm glad I've stepped away from that world and don't miss the WSDL days.
Re: Swagger: A simple, open standard for describing REST APIs with JSON
#10I was excited until I saw it was written in Java.
Same, will keep looking for something similar not in Java...