Forum Discussion
Hello exuraz , is it possible you can share the OAS3 document you use to get this error?
- exuraz5 years agoNew Contributor
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
- HKosova5 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 agoDavid_Be
- 2 years agoshyne
- 6 years agolalitha123
Recent Discussions
- 2 days agoankkashyap
- 6 days agoankkashyap