adding a new API document for player-api

Added a more systematic API documentation file.
The bit about "end of a lesson" seems unnecessary/misleading. Blocking gadgets can/will appear throughout the lesson.