REST Webhook can be used as a source in a template. While you have a pre-bundled set of REST providers to be used as a Simple Webhook type, you also have an option to create and use a REST provider as an Advanced REST Webhook type in a template according to your need.
If you have published a REST Provider as a Template, you will be able to select it from the designated drop-down box. You can also create a new one by clicking and use that as a source even when you are in the middle of creating a template.
Follow the steps below to create and use a REST Webhook as a source in a template.
For steps previous to the step 1 being discussed below, refer toCreating a Template.
Select REST Webhook as a source application.
Select the Webhook type as Simple or Advanced.
When Simple configuration is selected:
Select Enable SSL check box if you want the REST Provider service to offer a SSL security.
Select a port in the Select Port field.
You can also publish the REST Webhook to a custom port. To know more on how to do this, click here.
These two fields are available only when you have selected the Simple as a Webhook type.
When Advanced configuration is selected:
Select a pre-defined REST Provider in the Select Web Service Provider field.
When you create a new REST Provider from Template wizard:
The field Publish as will not be available and the REST Provider will be published as a Template.
By default, the REST Provider will be created in a published state.
Click Next.
Select the Apply Security Policy check box.
This screen appears only when you have selected Webhook type as Simple.
Select a pre-defined security policy in the Select Security Policy to applyfield. You can also create a new security policy by clicking .
Click Next to proceed to the next step of Template creation.
Once the Template is created, you can get the Webhook URL by clicking Copy URL (in case of Simple Webhook type) and Endpoint URL (in case of Advanced Webhook type)under the Action menu on the Templates manage page.
This option is available only when the Template is in active state.
The format of the copied URL for an Advanced Webhook type will be as follows:
<selected Scheme in Provider>://<API Gateway Host>:<Selected Port>/wsapi/apiVersion/resource end path
The table below explains the components of this URL for different cases:
Case
Endpoint
Scheme
Host
Port
Context path
No Port
GUI Scheme
API Gateway Host
GUI Port
/wsapi/resource end path
Non SSL Port
http
API Gateway Host
Selected Port
/wsapi/resource end path
SSL Port
https
API Gateway Host
Selected Port
/wsapi/resource end path
The format of the copied URL for a Simple Webhook type will be as follows:
<selected Scheme in Template Webhook Configuration>://<API Gateway Host>:<Selected Port>/rest/triggerprocess/<templateId>
The table below explains the components of this URL for different cases: