create reponses.md to DRY up what I foresee as repetition fo each resource. Added note and link to readme for JSON API.
Merge pull request #1 from KonaTeam/refactor

refactor