In addition to exposing RESTful interfaces and mediating RESTful invocations by mapping REST concepts to SOAP via proxy services, you can use the WSO2 ESB REST API to configure REST endpoints in the ESB by directly specifying HTTP verbs , URL patterns, and URI templates(such as POST and GET), URI templates, and URL mappings. This page describes how you can use the REST API to handle the following use cases:
...
For information on securing APIs, see Securing REST APIs with Basic Auth.
Enabling REST to SOAP
In this scenario, you expose a SOAP service over REST using an ESB REST API.
...
| Code Block | ||
|---|---|---|
| ||
<api name="StockQuoteAPI" context="/stockquote">
<resource uri-template="/view/{symbol}" methods="GET">
<inSequence>
<payloadFactory>
<format>
<m0:getQuote xmlns:m0="http://services.samples">
<m0:request>
<m0:symbol>$1</m0:symbol>
</m0:request>
</m0:getQuote>
</format>
<args>
<arg expression="get-property('uri.var.symbol')"/>
</args>
</payloadFactory>
<send>
<endpoint>
<address uri="http://localhost:9000/services/SimpleStockQuoteService" format="soap11"/>
</endpoint>
</send>
</inSequence>
<outSequence>
<send/>
</outSequence>
</resource>
<resource url-patternmapping="/order/*" methods="POST">
<inSequence>
<property name="FORCE_SC_ACCEPTED" value="true" scope="axis2"/>
<property name="OUT_ONLY" value="true"/>
<send>
<endpoint>
<address uri="http://localhost:9000/services/SimpleStockQuoteService" format="soap11"/>
</endpoint>
</send>
</inSequence>
</resource>
</api>
</definitions> |
...
In the second resource, we have defined a the URL pattern mapping as "/order/*". Since this has POST as the HTTP method, the client has to send a payload to invoke this. Following is a sample cURL command to invoke this:
...
The context of the REST API is ‘/Starbucks_Service’. For every HTTP method, a url-mapping or urluri-template is defined, and the URL to call these the methods differ with the defined mapping or template.
...