Software AG Products 10.7 | Service Development Help | Working with REST API Descriptors | OpenAPI Based Provider REST API Descriptors | Working with Resources | Working with Operations | About REST Requests
 
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.