adding a new API document for player-api

Added a more systematic API documentation file.
I recommend something more like "The gadget's UI should be updated to reflect the new values.". <- not sure how sharp that is but I'm not convinced everyone will know what "update the configuration visually" means. Not overly passionate about this... just a thought/worry.