7.1 KiB
OAV Errors Reference
This document includes further reference for errors reported by oav validate-spec command.
Index
Errors index
Errors described below indicate semantically incorrect OpenAPI2.0 files.
Errors Descriptions
Errors from OAV validate-spec command will include:
- Code: Unique identifier for the type of semantic error encountered
- Message: Details about the issue
- Path: Pointer to where the error/warning was detected
EQUIVALENT_PATH
Message : Equivalent path already exists: [path]
Description: Open API specification allows only unique paths.
How to fix the issue: Verify whether there are paths that are the same or that are parameterized in a way tha makes them equivalent. To fix the issue include all operations that share the same path under the same path section of the specification.
Links: Index | Error descriptions
OBJECT_MISSING_REQUIRED_PROPERTY_DEFINITION
Message : Missing required property definition:
Description: Property indicated as required for the operation is missing its definition.
How to fix the issue: Verify that the properties included in the 'required" array have all been defined.
Links: Index | Error descriptions
EMPTY_PATH_PARAMETER_DECLARATION
Message : Path parameter declaration cannot be empty: [parameter]
Description: Path paramater should be defined within the operation and not be empty.
How to fix the issue: Please verify that the all path parameters are defined for the operation and are not empty.
Links: Index | Error descriptions
DUPLICATE_OPERATIONID
Message : Cannot have multiple operations with the same operationId
Description: OperationIds must be unique within an OpenAPI specification.
How to fix the issue: Please verify that all operationIds are unique and update them if there are any duplicates.
Links: Index | Error descriptions
MULTIPLE_BODY_PARAMETERS
Message : Operation cannot have multiple body parameters
Description: Only one body parameter is allowed per operation.
How to fix the issue: Please check that there's only one parameter marked as body parameter ("in":"body").
Links: Index | Error descriptions
INVALID_PARAMETER_COMBINATION
Message : Operation cannot have a body parameter and a formData parameter
Description: Either body parameter or formData parameter are allowed per operation.
How to fix the issue: Please check there's only a body or a formData paramater exclusively.
Links: Index | Error descriptions
MISSING_PATH_PARAMETER_DEFINITION
Message : Path parameter is declared but is not defined: [parameter]
Description: Path parameter is included in path, but is not defined within the operation.
How to fix the issue: Please check that the parameter is defined within the operation.
Links: Index | Error descriptions
MISSING_PATH_PARAMETER_DECLARATION
Message : Path parameter is defined but is not declared: [parameter]
Description: There's a paramater defined as "in":"path", but not used/declared in the path of the operation.
How to fix the issue: Verify if the parameter should be part of the path and add it, or remove it from the definitions.
Links: Index | Error descriptions
UNRESOLVABLE_REFERENCE
Message : Reference could not be resolved: [ref]
Description: Reference cannot be resolved, path not found or file does not exist.
How to fix the issue: Please check reference is valid.
Links: Index | Error descriptions
ANY_OF_MISSING
Message : Not a valid [def] definition.
Description: OpenAPI structure is missing a section/keyword.
How to fix the issue: Please check that the defintion referenced is valid.
Links: Index | Error descriptions
ONE_OF_MISSING
Message : Not a valid [def] definition.
Description: OpenAPI structure is missing a section/keyword.
How to fix the issue: Please check that the defintion referenced is valid.
Links: Index | Error descriptions
INVALID_REFERENCE
Message : Invalid JSON Reference | Specific error details.
Description: Reference is invalid.
How to fix the issue: Please check that the reference is valid.
Links: Index | Error descriptions
OBJECT_MISSING_REQUIRED_PROPERTY
Message : Missing required property: [property]
Description: Property marked as required is missing in the operation.
How to fix the issue: Please specify the property that's indicated as required or remove it from being required.
Links: Index | Error descriptions
UNUSED_DEFINITION
Message : Definition is not used: [definition].
Description: Definition is not referenced/used in the file.
How to fix the issue: Please check if the definition is needed in the file, remove it if not needed or reference it appropriately.
Links: Index | Error descriptions
DUPLICATE_PARAMETER
Message : Operation cannot have duplicate parameters: [parameter]
Description: Parameters should be unique for the operation.
How to fix the issue: Please check there are no duplicate parameter names or rename as needed.