This section explains the process of creating web service provider activity for RESTful Web Service.
Steps to Use Web Service Provider Activity to Publish RESTful Web Service
...
On the Develop tab, click Services > Web Service > Provider (API).
Click Create New.
...
...
Type the name and description of the new Web Service Provider activity in the Name and Description text boxes.
...
By default, Character Set Encoding text box will display the character set encoding that you have defined at the application level. In case, the Web Services Provider activity contains characters which fall in character set encoding other than the default character set encoding, then you can change this encoding in the Character Set Encoding text box.
...
Type the resource end path URL in the Resource End Path text box. Provided end path URL can be static or dynamic:
Static URL example: /rest/WeatherForecast
Dynamic URL example: /rest/{ServiceName} where service name is a variable, for example, WeatherForecast.
| Info |
|---|
| The variable name in the Dynamic URL must be in the curly braces {}. |
...
Select the process flow name that you want to trigger with this web service from the Process Flow Name drop-down list.
| Info |
|---|
|
...
To define the resource parameters, type the name, default value, and style of the parameters in the Name, Default Value, and Style text boxes.
| Info |
|---|
For the parameters that you want to pass as a part of HTTP header, select Header corresponding to the parameters in the Style drop-down list. |
To add methods to your activity, click Add Method. Do the following.
...
Select the type of method from the Method Type drop-down list. The available method types are PUT, GET, POST, or DELETE. Depending upon the selection of the method type, the content of the Presentation table appears.
...
In the Method Parameter table, define the method parameters. Type the name, default value, and style of the parameters in the Name, Default Value, and Style text boxes.
| Info |
|---|
For the parameters that you want to pass as a part of HTTP header, select the Header option in the Style drop-down list. |
...
Select the security policy from the Security Policy drop-down list.
| Info |
|---|
For information on how to create a Security Policy, refer to Creating Security Policy for Web Service. The RESTful Web Service Provider supports both basic and API authentication. |
...
Click Save.
| Info | ||||||||
|---|---|---|---|---|---|---|---|---|
When a RESTFul web service is invoked by a Consumer, following information is saved in the process flow context:
You can view the value of these variables in Process Flow Context, within Process Flow Logs. Also, you can view these variables within your process flow using put-context-var action. |
...
Add API Documentation
To add API Documentation for RESTful web services:
- On the Develop tab, click Services > Web Service > Provider (API).
- Click Action
to the Restful web service. Click Add Documentation.
An The Add API Documentation window appears for the chosen RESTful web service.
API Details Description Name Name of the API Documentation. By default, it shows the provider's value as the name. Description Description about the API Documentation. Contact Email Valid email address to send queries. Title Title of your API documentation. It must contain alphanumeric and few special characters (_ - . : , @ $ ? \\ and space) and must start with an Alphabet/Underscore/Number) Method Details Description Summary Purpose of the method. Notes Description about the method. API Parameters Define API parameters by clicking Add Row. Method Presentation Status code of the request, response, and fault. You can also provide the description of the status code. - Click Save.
View Endpoint URL and API Documentation
After you have created RESTful Web Service for the Provider Activity, you can also view the Endpoint URL and API documentation. To view Endpoint URL and API Doc:
...