About REST Requests
When you select
Request for an operation,
Designer displays the input parameters in the REST V2 resource service that corresponds to the operation and the request body details.
REST request parameters and request body details
Parameters
When you select
Parameters under
Request, for each parameter,
Designer displays the following information:
Name: Matches the name of the input parameter in the corresponding service.
Type: Specifies the data type of the parameter.
Source: Indicates the source of the parameters in the incoming request. The source corresponds to the
in field of the parameter object as defined by the OpenAPI Specification 3.0.x. A parameter can have one of the following source values:
PATH
QUERY
HEADER
COOKIE
Required: Indicates whether or not the parameter is required in the input.
Designer obtains this value from the
Required property for the parameter in the corresponding REST V2 resource service.
You can also click
to view the additional parameter details, for example,
Media type,
Style,
Extensions, and
Constraints.
Request Body
The body of the REST requests lists the media types consumed by the operation, for example, application/json and specifies the schema for each media type. Designer displays the following details for the REST request:
Name: Specifies the media type.
Type: Specifies the data type.
Constraints: Indicates the composed keywords used to validate the schema for the request body.
Designer can use one or more of the following supported constraints to validate schemas as per OpenAPI Specification 3.0.x.
oneOf: Validates a value against exactly one of the subschemas.
allOf: Validates a value against all the subschemas.
anyOf: Validates a value against any (one or more) of the subschemas.
not: Ensures that the value is not valid against a specified schema.
Required: Indicates whether or not the request body is required in the input.
Designer obtains this value from the
Required property for the request body.