- Notifications
You must be signed in to change notification settings - Fork3
🐍Python 3 Examples for Salesforce Oauth2 Flows, REST and Metadata API
License
NotificationsYou must be signed in to change notification settings
jctissier/salesforce-oauth2-REST-Metadata-API-Examples
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Python implementations of Salesforce Oauth2 Flows, as well as authenticated REST API and Metadata API requests. Grab the code from this repository and get started!
Using these code samples, you could easily spin up a web app that will interact with your various Salesforce Orgs and manipulate your data.
| Topic | SF Documentation | Code Sample |
|---|---|---|
| Oauth - Username-Password | Link | Link |
| Oauth - User-Agent | Link | Link |
| Oauth - Web Server | Link | Link |
| Force.com REST API | Link | Link |
| Metadata API - Not completed | [Link] | [Link] |
| Notes |
| Salesforce Documentation | Code Sample |
|---|
Example
oauth=SalesforceOAuth2(client_id='your_client_id',client_secret='your_client_secret',username='your_username',password='your_password',token='your_token',sandbox=True# True = test.salesforce.com, False = login.salesforce.com)sf_authentication=oauth.get_access_token()response=sf_authentication.json()print(response)
JSON Response
{"signature":"B4UPTuymHFtTDZiI728H0LZ1/4LxebOjestj+EcwFDU=","issued_at":"1493144749805","instance_url":"https://na40.salesforce.com","id":"https://test.salesforce.com/id/00D7B000000DFeXUAW/0057A000001Zp0CQRD","token_type":"Bearer","access_token":"00D7AA00000DFeX!AQcAQCOOnJsOicbB6mknoxIH02wxjljnjKI739g1EoDBEOpQXomAV1iMG2EWGuU2gJ26o40ixi6jyD3AstyLgkiU29GNod2d"}| Salesforce Documentation | Code Sample |
|---|
Example
This example was created from a Python script, which is why I had to scrape the authorization URL. Once setup on a proper App, redirect to Salesforce's authentication will happen automatically.
oauth=SalesforceOAuth2(client_id='your_client_id',redirect_uri='https://www.enter-url-here.com/',# Must match Connected App's Callback URLsandbox=True)response=oauth.get_access_token()print(response.text)# Response's text content, find the Oauth2 URL
Response Text - HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html><head><metaHTTP-EQUIV="PRAGMA"CONTENT="NO-CACHE"><script>if(this.SfdcApp&&this.SfdcApp.projectOneNavigator){SfdcApp.projectOneNavigator.handleRedirect(''https://test.salesforce.com/?ec=302&startURL=%2Fsetup%2Fsecur%2FRemoteAccessAuthorizationPage.apexp%3Fsource%3DCAAAAVunKc0dfaE8wSjAwMDAwMDAwMDA0AAAAzvLd_MBDrJdD85NeTpeBvyJvMu13glHu-8SVW8OQVZoQkVxSt-DVCbYGXkgb-HaElPfp89r4HoQgxLsRC1awHznfguj2J1oJF3JRBdT3R2qgxT3l9yYCkzGnbE5-sdugAbszvylp78uGqPEJGguDD8a10tk7tktDeH02k5NWmF4UX8NM1oIiR_heDIw8TNOYRbTFhnqmSugZEGMiRj6ao7BTl1lxCtoZFERLtdKciNqkC0fLuFXFW4BDcQwTBacXfNm2ScrVZDGeRrNeHQYfJnPDJG1prLKJDrNOIyMtBslcoyYnDuuqBR0ENCdp64Yh69o74fVJMgwEjyM3ugVFHASpZp0AaWAy0P9XA5VXhNTA7eXFp9jLUw89NKNs5xwpxJOZe66oypSSVNjFCETsK8qVTzPCkL4QgGKLAd3Pzf5kXYSGpCTT7sZohaFY7yAMzJAn7gU7jsiA2D68dl-rjMgIGydVuGFq_4LF-EW4Zg%253D%253D');}elseif(window.location.replace){window.location.replace('https://test.salesforce.com/?ec=302&startURL=%2Fsetup%2Fsecur%2FRemoteAccessAuthorizationPage.apexp%3Fsource%3DCAAAAVunKc0dfaE8wSjAwMDAwMDAwMDA0AAAAzvLd_MBDrJdD85NeTpeBvyJvMu13glHu-8SVW8OQVZoQkVxSt-DVCbYGXkgb-HaElPfp89r4HoQgxLsRC1awHznfguj2J1oJF3JRBdT3R2qgxT3l9yYCkzGnbE5-sdugAbszvylp78uGqPEJGguDD8a10tk7tktDeH02k5NWmF4UX8NM1oIiR_heDIw8TNOYRbTFhnqmSugZEGMiRj6ao7BTl1lxCtoZFERLtdKciNqkC0fLuFXFW4BDcQwTBacXfNm2ScrVZDGeRrNeHQYfJnPDJG1prLKJDrNOIyMtBslcoyYnDuuqBR0ENCdp64Yh69o74fVJMgwEjyM3ugVFHASpZp0AaWAy0P9XA5VXhNTA7eXFp9jLUw89NKNs5xwpxJOZe66oypSSVNjFCETsK8qVTzPCkL4QgGKLAd3Pzf5kXYSGpCTT7sZohaFY7yAMzJAn7gU7jsiA2D68dl-rjMgIGydVuGFq_4LF-EW4Zg%253D%253D');}else{;window.location.href='https://test.salesforce.com/?ec=302&startURL=%2Fsetup%2Fsecur%2FRemoteAccessAuthorizationPage.apexp%3Fsource%3DCAAAAVunKc0dfaE8wSjAwMDAwMDAwMDA0AAAAzvLd_MBDrJdD85NeTpeBvyJvMu13glHu-8SVW8OQVZoQkVxSt-DVCbYGXkgb-HaElPfp89r4HoQgxLsRC1awHznfguj2J1oJF3JRBdT3R2qgxT3l9yYCkzGnbE5-sdugAbszvylp78uGqPEJGguDD8a10tk7tktDeH02k5NWmF4UX8NM1oIiR_heDIw8TNOYRbTFhnqmSugZEGMiRj6ao7BTl1lxCtoZFERLtdKciNqkC0fLuFXFW4BDcQwTBacXfNm2ScrVZDGeRrNeHQYfJnPDJG1prLKJDrNOIyMtBslcoyYnDuuqBR0ENCdp64Yh69o74fVJMgwEjyM3ugVFHASpZp0AaWAy0P9XA5VXhNTA7eXFp9jLUw89NKNs5xwpxJOZe66oypSSVNjFCETsK8qVTzPCkL4QgGKLAd3Pzf5kXYSGpCTT7sZohaFY7yAMzJAn7gU7jsiA2D68dl-rjMgIGydVuGFq_4LF-EW4Zg%253D%253D';}</script></head></html><!-- Body events --><scripttype="text/javascript">functionbodyOnLoad(){if(window.PreferenceBits){window.PreferenceBits.prototype.csrfToken="null";};}functionbodyOnBeforeUnload(){}functionbodyOnFocus(){}functionbodyOnUnload(){}</script></body></html>
Extract Redirect URL
window.location.href='https://test.salesforce.com/?ec=302&startURL=%2Fsetup%2Fsecur%2FRemoteAccessAuthorizationPage.apexp%3Fsource%3DCAAAAVunKc0dfaE8wSjAwMDAwMDAwMDA0AAAAzvLd_MBDrJdD85NeTpeBvyJvMu13glHu-8SVW8OQVZoQkVxSt-DVCbYGXkgb-HaElPfp89r4HoQgxLsRC1awHznfguj2J1oJF3JRBdT3R2qgxT3l9yYCkzGnbE5-sdugAbszvylp78uGqPEJGguDD8a10tk7tktDeH02k5NWmF4UX8NM1oIiR_heDIw8TNOYRbTFhnqmSugZEGMiRj6ao7BTl1lxCtoZFERLtdKciNqkC0fLuFXFW4BDcQwTBacXfNm2ScrVZDGeRrNeHQYfJnPDJG1prLKJDrNOIyMtBslcoyYnDuuqBR0ENCdp64Yh69o74fVJMgwEjyM3ugVFHASpZp0AaWAy0P9XA5VXhNTA7eXFp9jLUw89NKNs5xwpxJOZe66oypSSVNjFCETsK8qVTzPCkL4QgGKLAd3Pzf5kXYSGpCTT7sZohaFY7yAMzJAn7gU7jsiA2D68dl-rjMgIGydVuGFq_4LF-EW4Zg%253D%253D';
- Open URL in browser, you will be redirected to Salesforce's login page.
- Enter your credentials and sign in, if successful, you will automatically be redirected to your <redirect_uri> (example: 'https://www.enter-url-here.com/') and the authentication parameters will be attached to the URL.
Extract parameters from Callback URL -(with a URL Decoder)
https://www.enter-url-here.com/# access_token=00D7A000000DFeX%21AQcAQAq3T51g1uXSy13a0OLnzgJftZZDu6yMeYycS_Tgcb4r_m9Pl.0ttCVQjEfBRGk3xaDDPjCX3EMwozIDiTW4Ug9siU0z& instance_url=https%3A%2F%2Fna40.salesforce.com& id=https%3A%2F%2Ftest.salesforce.com%2Fid%2F00D7A000000DFeXUAW%2F0057A000001XZo7QAG& issued_at=1493149331818& signature=7CGg53xYc7zJvGQI%2FCpCREC9Vg7BnnNkbIZpb4ZPrHk%3D& scope=full& token_type=Bearer| Salesforce Documentation | Code Sample |
|---|
Example
This flow is normally used on a Web App, but the example below is done in Python since it's easier to show in an example.
importwebbrowserimporturllib.parseasurlparseoauth=SalesforceOAuth2(client_id='your_client_id',client_secret='your_client_secret',redirect_uri='https://www.enter-url-here.com/',sandbox=True# True = test.salesforce.com, False = login.salesforce.com)oauth_redirect=oauth.authorize_login_url()webbrowser.open(oauth_redirect)# This will open the Authentication Salesforce Login page
- Fill in your credentials and Login, you will be redirected to your app's callback URL, Copy the URL Link (with the parameters)
# https://www.enter-url-here.com/?code=aPrxILdoIUt7J4zOidrhMRBqhwgwsTAh7expE53Qeh2KhelBXIzspDZ8nPV8t7uADsOHeWXz5g%3D%3Dcallback_url=input('Copy-Paste your callback URL and press ENTER')# Extract the code from the URLextract_code=urlparse.urlparse(url)code=urlparse.parse_qs(extract_code.query)['code'][0]print(code)# aPrxILdoIUt7J4zOidrhMRBqhwgwsTAh7expE53Qeh2KhelBXIzspDZ8nPV8t7uADsOHeWXz5g==# Retrieve access_token from Salesforce by sending authenticated codesf_authentication=oauth.get_access_token(code)print(sf_authentication.json())# Print the JSON response
JSON Response
{"signature":"B4UPTuymHFtTDZiI728H0LZ1/4LxebOjestj+EcwFDU=","issued_at":"1493144749805","instance_url":"https://na40.salesforce.com","id":"https://test.salesforce.com/id/00D7B000000DFeXUAW/0057A000001Zp0CQRD","token_type":"Bearer","access_token":"00D7AA00000DFeX!AQcAQCOOnJsOicbB6mknoxIH02wxjljnjKI739g1EoDBEOpQXomAV1iMG2EWGuU2gJ26o40ixi6jyD3AstyLgkiU29GNod2d","scope":"full","id_token":"<1108 characters long>"}| Salesforce Documentation | Code Sample |
|---|
Example
Username-Password Flow is the easiest to use as an example.
oauth=SalesforceOAuth2(client_id='your_client_id',client_secret='your_client_secret',username='your_username',password='your_password',token='your_token',sandbox=True# True = test.salesforce.com, False = login.salesforce.com)sf_authentication=oauth.get_access_token()json_response=sf_authentication.json()
- Authenticate and extract the
access_tokenandinstance_urlfrom the JSON response.
access_token=json_response['access_token']instance_url=json_response['instance_url']
- Create a REST API request with the authenticated credentials
rest=RESTApi(access_token=access_token,instance_url=instance_url)get_request=rest.rest_api_get(rest_url='sobjects/Account',api_version='39.0')# full url = instance_url/services/data/v39.0/sobjects/Accountprint(get_request)# <Response [200]>print(get_request.json())"""{'recentItems': [], 'objectDescribe': {'feedEnabled': True, 'layoutable': True, 'replicateable': True, 'deprecatedAndHidden': False, 'updateable': True, 'mergeable': True, 'activateable': False, 'name': 'Account', 'searchable': True, 'queryable': True, 'undeletable': True, 'retrieveable': True, 'deletable': True, 'mruEnabled': True, 'isSubtype': False, 'customSetting': False, 'label': 'Account', 'triggerable': True, 'hasSubtypes': False, 'custom': False, 'urls': {'listviews': '/services/data/v39.0/sobjects/Account/listviews', 'compactLayouts': '/services/data/v39.0/sobjects/Account/describe/compactLayouts', 'defaultValues': '/services/data/v39.0/sobjects/Account/defaultValues?recordTypeId&fields', 'quickActions': '/services/data/v39.0/sobjects/Account/quickActions', 'rowTemplate': '/services/data/v39.0/sobjects/Account/{ID}', 'layouts': '/services/data/v39.0/sobjects/Account/describe/layouts', 'sobject': '/services/data/v39.0/sobjects/Account', 'describe': '/services/data/v39.0/sobjects/Account/describe', 'approvalLayouts': '/services/data/v39.0/sobjects/Account/describe/approvalLayouts'}, 'keyPrefix': '001', 'labelPlural': 'Accounts', 'createable': True}}"""
| Salesforce Documentation | Code Sample |
|---|
Example
Username-Password Flow is the easiest to use as an example. (Same setup as REST API)
oauth=SalesforceOAuth2(client_id='your_client_id',client_secret='your_client_secret',username='your_username',password='your_password',token='your_token',sandbox=True# True = test.salesforce.com, False = login.salesforce.com)sf_authentication=oauth.get_access_token()json_response=sf_authentication.json()
- Authenticate and extract the
access_tokenandinstance_urlfrom the JSON response.
access_token=json_response['access_token']instance_url=json_response['instance_url']
Author: Jean-Claude Tissier
Feel free to contribute and create an issue if you are having problems with some of the code.
About
🐍Python 3 Examples for Salesforce Oauth2 Flows, REST and Metadata API
Topics
Resources
License
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Releases
No releases published
Packages0
No packages published