It's really, really nice to see an API with all the validating JSON Schemas publically available[1]. I wish everybody did this. We have been doing a lot of thi

It's really, really nice to see an API with all the validating JSON Schemas publically available[1]. I wish everybody did this. We have been doing a lot of thinking at Snowplow [2] [3] about JSON Schema versioning and self-description. One of the key points as it relates to RESTful APIs is: it's not enough to version your API, you should be versioning the individual entities that your API returns; these entities should be able to individually evolve over time, with the focus on evolving the entities' schemas in additive (i.e. non-breaking ways) for existing clients. There's quite a lot to learn from the Avro community in all this. [1] https://github.com/balanced/balanced-api/tree/master/fixtures https://github.com/balanced/balanced-api/tree/master/fixture... [2] http://snowplowanalytics.com/blog/2014/05/13/introducing-schemaver-for-semantic-versioning-of-schemas/ http://snowplowanalytics.com/blog/2014/05/13/introducing-sch... [3] http://snowplowanalytics.com/blog/2014/05/15/introducing-self-describing-jsons/ http://snowplowanalytics.com/blog/2014/05/15/introducing-sel...