typo
add usage and problem info to API

We follow http://tools.ietf.org/html/draft-nottingham-http-problem
for returning defined API error messages
set api-problem MIME only to accepting clients
make API more robust