KnowledgeCaptureAndDiscovery / OBA

Ontology based APIs
Apache License 2.0
38 stars 12 forks source link

Validate openapi specification output #133

Closed dgarijo closed 4 years ago

dgarijo commented 4 years ago

In in the config.yaml you have:

  servers:
    - url: http://localhost:8080/v1
    - description: localhost server

then the spec will produce:

servers:
 - url: http://localhost:8080/v1
 - description: localhost server

which fails according to the openAPI spec. We should validate the full spec before wrapping it up

mosoriob commented 4 years ago

From: https://github.com/KnowledgeCaptureAndDiscovery/OBA/issues/132

dgarijo commented 4 years ago

See https://mvnrepository.com/artifact/io.swagger.validator.v3/swagger-validator (Hernan also mentions there are libs already in the project for this)

dgarijo commented 4 years ago

OBA does validation, but the problem is that some valid APIs have missing schemas, which is problematic.