Inbound rest web service
Download as PPTX, PDF0 likes389 views
This document provides instructions on how to develop an inbound REST web service in Salesforce. It describes creating an Apex class to retrieve a contact based on email, generating an access token, and using Runscope to test the web service by calling the endpoint with the authorization header and email query string parameter.
![@RestResource(urlMapping='/getContact/*’)
global with sharing class RestWSDemo {
@HttpGet
global static List<Contact> getContact() {
String Email = RestContext.request.params.get('Email');
List<Contact> contactResult = [ Select ID, Name, Description, Birthdate from Contact where Email = :Email];
return contactResult;
}
}
David Boukhors - Expert Salesforce 5
This code will retrieve a contact based on the Input Email](https://image.slidesharecdn.com/inboundrestwebservice-150726175420-lva1-app6892/85/Inbound-rest-web-service-5-320.jpg)
Inbound rest web service
- 1. SalesforceTutorial How to developp an Inbound REST Web Service David Boukhors – Salesforce Expert
- 2. Prerequesites • Sign up for a runscope account: • https://www.runscope.com • Create some contact data on your salesforce org. David Boukhors - Expert Salesforce 2
- 3. Salesforce Administration • You’ll just need a user with SalesforceAdmin Profile. David Boukhors - Expert Salesforce 3
- 4. Create the APEX Class David Boukhors - Expert Salesforce 4 Click on New and create an APEX Class with the following code. And Save it.
- 5. @RestResource(urlMapping='/getContact/*’) global with sharing class RestWSDemo { @HttpGet global static List<Contact> getContact() { String Email = RestContext.request.params.get('Email'); List<Contact> contactResult = [ Select ID, Name, Description, Birthdate from Contact where Email = :Email]; return contactResult; } } David Boukhors - Expert Salesforce 5 This code will retrieve a contact based on the Input Email
- 6. Create an App David Boukhors - Expert Salesforce 6 Cochez Enable Oauth Settings et donner full access
- 7. Consumer Key and Secret • Now click on your created app and you’ll find two usefull information a consumer key and a consumer secret, under API (Enable Oauth Settings section) David Boukhors - Expert Salesforce 7
- 8. How to get your security token • Go to Your Name > Settings and select Personal > Reset my security token • You will receive your security token by mail David Boukhors - Expert Salesforce 8
- 9. Generate an access token for Runscope • Open a terminal (on Unix environment) and run this command: curl --form client_id=<your consumer key> --form client_secret=<your consumer secret> --form grant_type=password --form username=<your salesforce username (email)> --form password=<password concatenated with security token> https://eu5.salesforce.com/services/oauth2/token David Boukhors - Expert Salesforce 9 The last parameter is an url which depends on your salesforce org. Just look at your browser url while using salesforce
- 10. • You’ll get this kind of answer, which is a token for runscope, valid only for one hour: • > https://eu5.salesforce.com/services/oauth2/token • {"id":"https://login.salesforce.com/id/000000YMstEAG/005 2400AG","issued_at":"1437932208386","token_type":"Bear er","instance_url":"https://eu5.salesforce.com","signature" :"blablabla","access_token":"MYACCESSTOKEN"} David Boukhors - Expert Salesforce 10
- 11. Test theWeb Service with Runscope • Sign on to Runscope and create a new test with the following parameter. David Boukhors - Expert Salesforce 11
- 12. Runscope test EndPoint • Add an endpoint: https://eu5.salesforce.com/services/apexrest/<y our package name if you have set one>/getContact David Boukhors - Expert Salesforce 12
- 13. Runscope test Header David Boukhors - Expert Salesforce 13 • Add the following header Name = Authorization Value = Bearer <your runscope access token> Don’t forget the space between Bearer keyword and your access token
- 14. Runscope test Querystring • Add this parameter, with an email which refers to an existing contact in your Salesforce Org David Boukhors - Expert Salesforce 14
- 15. Now run the test! David Boukhors - Expert Salesforce 15