Authentication Overview

Always provide an overview of what type of authentication is provided for an API. Don’t assume developers will know anything about Basic Auth or oAuth. Walk developers through goals behind authentication, with links to tutorials regarding authentication technology.

If an API employs oAuth, make sure and take extra special attention to provide clear instructions on how to use, as well as language specific code as part of your API SDKs. After poor API documentation, oAuth integration is the number one stumbling point for API developers.