fix broken ref links in docs

fixes #48
document GET /authorization

fixes #47, fixes #50
include curl examples in api docs

fixes #49