Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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. 

Info

For steps previous to the step 1 being discussed below, refer to Creating a Template.

  1. Select REST Webhook as a source application.



  2. Select the Webhook type as Simple or Advanced.



  3. When Simple configuration is selected:
    1. Select Enable SSL check box if you want the REST Provider service to offer a SSL security. 
    2. Select a port in the Select Port field.

      Tip

      You can also publish the REST Webhook to a custom port. To know more on how to do this, click here.


      Note
      These two fields are available only when you have selected the Simple as a Webhook type.


  4. When Advanced configuration is selected:



    1. Select a pre-defined REST Provider in the Select Web Service Provider field.

    2. You can also create a new provider by clicking 

      Note

      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.


  5. Click Next.
  6. Select the Apply Security Policy check box.

    Note
    This screen appears only when you have selected Webhook type as Simple.


  7. Select a pre-defined security policy in the Select Security Policy to apply field. You can also create a new security policy by clicking .
  8. Click Next to proceed to the next step of Template creation.

Info

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.

Note
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:

CaseEndpoint
SchemeHostPortContext path
No PortGUI SchemeAPI Gateway HostGUI Port/wsapi/resource end path
Non SSL PorthttpAPI Gateway HostSelected Port/wsapi/resource end path
SSL PorthttpsAPI Gateway HostSelected Port/wsapi/resource end path

The format of the copied URL for a Simple Webhook type will be as follows:

<selected Scheme in in Template Webhook Configuration>://<API Gateway Host>:<Selected Port>/rest/triggerprocess/<templateId>

The table below explains the components of this URL for different cases:

Case

Endpoint


SchemeHostPortContext pathNo PortGUI SchemeAPI Gateway HostGUI Port/rest/triggerprocess/<templateId>
Non SSL PorthttpAPI Gateway HostSelected Port/rest/triggerprocess/<templateId>
SSL PorthttpsAPI Gateway HostSelected Port/rest/triggerprocess/<templateId>