Add Responses
To virtualize an API, you need to create responses for virtual requests. You can create multiple responses for one request. The virtual service will use the dispatch settings to select a response for the reply.
To create a response, simply click Add Response for the desired request in the virtual service editor:
Click the image to enlarge it.
Note that, after you create an operation, ReadyAPI creates an empty response for it. Also, if you use the Discovery feature to virtualize your REST or SOAP API, ReadyAPI records all the responses the existing API sends for a request.
Set Response Contents
After adding a response, you need to specify its contents. You do this in the editor on the right. The editor fields and contents depend on the virtual service type: REST, SOAP and JMS services use different response properties:
-
For REST and SOAP services, set the HTTP status code field. It specifies the response code to be returned to clients. The clients use it to determine if the request was successful or not.
As for the response data, you can enter them into the Edit field:
Click the image to enlarge it.
-
For JMS virtual services, you specify the response contents in the Edit fields. Also, check the JMS Destination properties: they specify the JMS session, topic or queue, to which the service will send the response:
Click the image to enlarge it.
-
For JDBC virtual services, you change the response contents in the Result section. Depending on the query, the section contains the table with data or the number of rows mudified.
Click the image to enlarge it.
For information on specific settings to be made, see topics of the Virtual Service Specifics section. For complete information on response properties, see Reference.
Set Custom Headers
Besides response body data, you can also add custom headers to responses. You do this in the Headers section:
Click the image to enlarge it.
Custom headers can include virtual service properties and the data source's data (see below).
Use Virtual Service Properties and Data Source Data
You can customize the response data by inserting virtual service properties and the data source's data into them. This will allow you to create responses that have the same structure, but contain different data.
You can include the properties into response contents and headers. You do this by typing expressions that have a syntax like this:
${MockService-service-property-name}
${MockResponse#datasource-property}
For complete information, see Property Expansion in Responses and Data Sources in Virtual Services.
See Also
Configuring Virtual Services
Creating Requests (Operations)
Property Expansion in Responses
Data Sources in Virtual Services