This document discusses invoking RESTful web services with BizTalk Server 2010. It defines REST and the HTTP methods used in REST. It also describes how to invoke REST services without native support in BizTalk, including specifying the HTTP method and encoding/decoding messages. Extending WCF with custom behaviors is suggested for implementing REST in BizTalk. Sample code and additional resources are provided.

1. Invoking ReSTful Services
Daniel Toomey, Mexia Consulting
Senior Integration Specialist

2. •
–
–
–
–
–
•
– http://social.technet.microsoft.com/wiki/contents/articles/invoke-
restful-web-services-with-biztalk-server-2010.aspx

3. • Re S T
•
•
HTTP CRUD
PUT CREATE
GET RETRIEVE
POST UPDATE
DELETE DELETE

4. •
•
http://www.contoso.com/Customer/Details/9999
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope "
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding ">
<soap:body pb="http://www.contoso.com/customer ">
<GetDetails>
<ID>9999</ID>
</GetDetails>
</soap:Body>
</soap:Envelope>
http://www.contoso.com/Customer/Details?firstName
=John&lastName=Smith

5. •
–
–
•
–
–
• No OOTB support for ReST 
5

6. •
– Specify HTTP method in the request message
– URL path & query string template
– Encoding request / Decoding response
• WCF 4.0 Extensions
– Message Inspectors
– Extension to client runtime via custom behavior configuration
– Must be registered in the machine.config file
– More on “Extending WCF with Custom Behaviors”:
– http://msdn.microsoft.com/en-us/magazine/cc163302.aspx
6

7. • http://msdn.microsoft.com/en-us/magazine/cc163302.aspx
7

8. • http://msdn.microsoft.com/en-us/magazine/cc163302.aspx
8

9. 1.
2.
3.
4.
9

10. 1.
2.
3.
4.
10

11. •
–
–
–
–
http://code.msdn.microsoft.com/Invoking-ReSTful-Web-with-
776ceb78

12. Twiiter_BTS

13. •
http://www.ibm.com/developerworks/webservices/library/ws-restful/
•
http://www.predic8.com/rest-webservices.htm
•
http://rest.elkstein.org/
•
http://msdn.microsoft.com/en-us/magazine/cc163302.aspx
•
http://weblogs.asp.net/gsusx/archive/2011/02/08/tellago-devlabs-a-restful-api-
for-biztalk-server-business-rules.aspx
•
http://www.microsoft.com/downloads/en/details.aspx?FamilyID=FF6E4498-
B1FF-4932-BA6B-1B53AC6FB3B2&displaylang=en
•
http://weblogs.asp.net/gsusx/archive/2011/02/08/tellago-devlabs-a-restful-
api-for-biztalk-server-business-rules.aspx
13

14. 14