add REST documentation for mediacore module

I'd be in favour of documenting the `embedCode.url` here as well, as it will be part of the returned object. 

Given that `callback.embedCode` now has 2 properties, it would probably be better to rename it to something like `callback.embedInfo`