REST plugin use cases

1 minute readExtensibilityDeveloper productivity

This section describes common use cases for the REST plugin and provides example requests and responses.

GET request with no authentication

A common use for the REST plugin is to create GET requests that retrieve information from RESTful web services without providing authentication. After you enter the required information and run the step, the plugin:

  1. Creates the request and sends it to the server.

  2. Waits for the success or failure response.

  3. Writes the response using the specified method.

The following is an example runRest procedure GET request configuration for this type of use case:

runRest GET example configuration
Figure 1. runRest GET example configuration

The following is an example of the server response for the previous request:

runRest GET server response
Figure 2. runRest GET example server response

POST request with basic authentication

A common use for the REST plugin is to create POST requests that retrieve or change information on your server where authentication is required. After you enter the required information and run the step, the plugin:

  1. Creates the request and sends it to the server.

  2. Waits for the success or failure response.

  3. Writes the response using the specified method.

The following is an example runRest procedure POST request configuration for this type of use case:

runRest POST example configuration
Figure 3. runRest POST example configuration

The following is an example of the server response for the previous request:

runRest POST server response
Figure 4. runRest POST example server response