This guide explains the elements of a JSON document representing a request test definition. A request test definition lists test case inputs for all of the API requests defined in an OpenAPI v3 specification. You can generate the request test definition for an OpenAPI specification by running Tcases for OpenAPI with options for input resolution.
The JSON schema for a request test definition document is located at http://www.cornutum.org/tcases/request-cases-schema.json.
Note: Required fields are designated by the ®️ symbol. All other fields are optional.
A request test definition is an array of RequestCase objects that lists the test cases for all API requests.
A RequestCase object defines the inputs for a test case that invokes a specific API request.
| Field | Type | Description | |
|---|---|---|---|
| id | integer | ®️ | An id number that uniquely identifies this test case among all tests for the given path and operation |
| path | string | ®️ | The request path |
| operation | string | ®️ | The HTTP operation for this request |
| api | string | ®️ | The title of the API that defines this request |
| name | string | A descriptive name for this test case | |
| server | string | The API server URL | |
| version | string | The version of the OpenAPI spec that defines this request | |
| parameters | [ParamData] |
The parameter values for this request | |
| body | MessageData |
The body value for this request | |
| invalidInput | string | If defined, a failure response is expected for this request and this string describes the invalid input |
A ParamData object specifies the name, value, and encoding of a request parameter. A ParamData object is the same as a MessageData object,
with the following additional fields.
| Field | Type | Description | |
|---|---|---|---|
| name | string | ®️ | The name of this parameter |
| in | string | ®️ | The location of this parameter |
| style | string | ®️ | Defines how this parameter value will be serialized |
| explode | boolean | For parameters of type array or object, specifies if elements will be serialized in exploded form |
A MessageData object specifies the value and encoding of a request input data item.
| Field | Type | Description | |
|---|---|---|---|
| data | DataValue |
®️ | Defines the value of this data item |
| valid | boolean | ®️ | Defines if the value for this data item is valid or invalid (i.e. failure response expected) |
| mediaType | string | The media type used to represent the value of this data item |
A DataValue object specifies the type, format, and value of a request input data item.
| Field | Type | Description | |
|---|---|---|---|
| type | string | ®️ | The type of this data value |
| value | JSON value | ®️ | The JSON representation of this data value |
| format | string | The format of this data value |