Repository files navigation

This project provides first-class OAuth library support forRequests.

OAuth 1 can seem overly complicated and it sure has its quirks. Luckily,requests_oauthlib hides most of these and let you focus at the task at hand.

Accessing protected resources using requests_oauthlib is as simple as:

>>>from requests_oauthlibimport OAuth1Session>>> twitter= OAuth1Session('client_key',                            client_secret='client_secret',                            resource_owner_key='resource_owner_key',                            resource_owner_secret='resource_owner_secret')>>> url='https://api.twitter.com/1/account/settings.json'>>> r= twitter.get(url)

Before accessing resources you will need to obtain a few credentials from yourprovider (e.g. Twitter) and authorization from the user for whom you wish toretrieve resources for. You can read all about this in the fullOAuth 1 workflow guide on RTD.

OAuth 2 is generally simpler than OAuth 1 but comes in more flavours. The mostcommon being the Authorization Code Grant, also known as the WebApplicationflow.

Fetching a protected resource after obtaining an access token can be extremelysimple. However, before accessing resources you will need to obtain a fewcredentials from your provider (e.g. Google) and authorization from the userfor whom you wish to retrieve resources for. You can read all about this in thefullOAuth 2 workflow guide on RTD.

To install requests and requests_oauthlib you can use pip:

pip install requests requests-oauthlib