Update README for api content diff

[pjambet]

We also need to make some small improvements

• Use a parser based on the content type of the response instead of assuming JSON. We might want to add a way to override this per endpoint in case the content type of the response is wrong.
• Add optional authentication system. We currently only support oauth2, it should also work without any authentications