FYI: JSON-LD is already W3C standardized and may be interesting regarding APIs, especially in the area m2m:

See http://de.slideshare.net/lanthaler/building-next-generation-...

But my "fear" is that it will all get to complicated, too. Currently I really like to work with JSON Schema (http://json-schema.org/), because it's simple and extensible.