updated some api details
updated response with json sample
added defaults api responses
fix typo in defaults.md
Merge pull request #1 from michaelfung/master

Merge in updates by michaelfung