add REST documentation for mediacore module

Would it be worth moving these REST models to a separate `restmodel.js` file? 

/cc @mrvisser @simong @stuartf