It's really frustrating how in 2014 almost everybody is still writing API definitions which are only human-readable. Two worthy exceptions: - https://github.co

It's really frustrating how in 2014 almost everybody is still writing API definitions which are only human-readable. Two worthy exceptions: - https://github.com/balanced/balanced-api https://github.com/balanced/balanced-api - https://helloreverb.com/developers/swagger https://helloreverb.com/developers/swagger You can have self-describing messages without having to embed the schema in the instance. Instead you embed a reference to the schema in the message. We came up with an approach to this called self-describing JSONs: http://snowplowanalytics.com/blog/2014/05/15/introducing-self-describing-jsons/ http://snowplowanalytics.com/blog/2014/05/15/introducing-sel... The Avro community do something similar.