Update README and docs

[siddharthlatest]

Post v2.3 release (where we apply the custom headers and accept a URL that can have a prefix in its path), we should update the following docs:

• Readme (which is visible on github and npm),
• Official API reference doc over here.