refactor 

Create reponses.md to DRY up what I foresee as repetition fo each resource. Added note and link to readme for JSON API.