Bring apidoc inline with intent and server implementation

Implemented as raw json as body, and is nicer that way.
Merge pull request #191 from Seanstoppable/validation

Bring apidoc inline with intent and server implementation