change scopes to scope

fixes #10
add docs link to readme

fixes #11
make state required

fixes #13
change authorization endpoint to POST

fixes #14
adds a description for each endpoint

fixes #12
Merge pull request #17 from mozilla/api-adjustments

Api adjustments