Forum Discussion
Hello exuraz , is it possible you can share the OAS3 document you use to get this error?
hugomario yes, this is the file:
https://github.com/opentripmodel/opentripmodel/blob/master/api/swagger.yaml
It turned out the file has errors which are not detected by a lot of validators.
I found an OpenAPI validator from IBM which does see them and gives line numbers to fix them:
https://github.com/IBM/openapi-validator
- HKosova6 years agoSmartBear Alumni (Retired)
exuraz wrote:
It turned out the file has errors which are not detected by a lot of validators.
I found an OpenAPI validator from IBM which does see them and gives line numbers to fix them:
https://github.com/IBM/openapi-validator
From a quick look the file seems to be a valid OpenAPI 3.0 definition. Most (if not all) errors and warnings reported by IBM's openapi-validator are NOT syntax errors but custom style validations based on "custom IBM-defined best practices" such as:
Property names must be lower snake case.
Arrays MUST NOT be returned as the top-level structure in a response body.
Operations with non-form request bodies should set a name with the x-codegen-request-body-name annotation.These things aren't actually errors.
Related Content
- 2 years ago
- 7 years ago
Recent Discussions
- 4 days ago
- 26 days ago