It’s been a couple of weeks since i quickly hacked a first version of an API browser and presented it at the RubyUserGroup Cologne. It is now available online (at heroku) and gives a nice overview of a JSON-Schema for a(our) RESTful webservice.
In case you are still puzzled about JSON Schema see documentation here.
But WHY should you use JSONSchema to decribe your data and webservice?
- ever struggled to keep your API descriptions up to date?
- hate WSDL and need something simple?
- give API-clients an easy start to handle your API objects
- ever thought about API versioning?
Here again the links