Modifying the REST Definitions for SOAP Operations
You must have the Manage APIs functional privilege assigned to perform this task.
To modify the REST definitions for SOAP operation
1. Click APIs in the title navigation bar.
2. Select the required API from the list of available APIs.
The API details page for the selected API appears.
3. Click Edit.
4. Click REST transformation.
A list of SOAP operations already exposed to the consumers as well as to be transformed from SOAP to REST appears.
5. Click to activate SOAP to REST transformation, for the required operation. Alternatively, you can activate the SOAP to REST transformation for all the SOAP operations simultaneously by clicking the Transform all operations activation toggle button.
6. Provide the following information:
Field | Description |
Resource name | Name of the resource. The existing name of the SOAP operation automatically appears, you can modify this name. |
Resource path | Path of the resource. The existing path of the SOAP operation automatically appears, you can modify this path. |
Tags | Tags to add to your operation. Select tags for the operation from the drop-down menu. |
Description | Description of the resource. A few lines to describe the resource. This is an optional field. |
7. Click + Add Parameter and provide the following information to add the required resource level parameters:
Field | Description |
Name | Name of the parameter. |
Description | Description of the parameter. |
Type | Specifies the parameter type. Available values are: Path, Query-string. |
Data type | Specifies the data type. Available values are: String, Date, Date time, Integer, Double, Boolean. |
Required | Specifies the parameter is required if selected. |
Repeat | Applicable to parameters of type query. The query parameter value can take comma separated array values. |
Value | Specifies the possible value. |
XPath | Specifies how the request parameter must be mapped to the SOAP payload that is sent to the native SOAP service. For example, /soapenv:Envelope/soapenv:Body/axis:sayHello/axis:name, or //axis:name ( If the SOAP request has only one element such as name). |
Namespace prefix | Specifies the namespace prefix of the element that appears in the XPath. |
Namespace URI | Specifies the namespace URI for the XPath element. You can add more namespace prefixes and namespace URIs by clicking . |
You can add more parameters by clicking
.
8. Select one of the available methods: GET, POST, PUT, or DELETE. By default, POST is selected.
By default, API Gateway generates the sample JSON request and response based on the XML schema definitions of the SOAP API. Additionally, you can provide a schema and modify the generated sample.
9. Click Add Request and provide the schema and a sample for the content-type.
10. Click Add Response and select the status code from the drop-down and provide a description for the status code selected.
Additionally, to add a content-type to the status code selected, click the status code to which you want to add a content-type and select the Content type. Provide a schema and a sample for the content-type selected. By default, status code 200 is automatically generated by the system.
11. Click Save.