swagger-parser icon indicating copy to clipboard operation
swagger-parser copied to clipboard

io.swagger.parser.util.SwaggerDeserializer#SCHEMA_KEYS shoud contain value "externalDocs"

Open gynoro opened this issue 3 years ago • 3 comments

io.swagger.parser.util.SwaggerDeserializer#SCHEMA_KEYS shoud contain value "externalDocs", because swagger 2 specification allows the use of "externalDocs" in schema objects https://swagger.io/specification/v2/#schemaObject

This error is generated:

> There were issues with the specification. The option can be disabled via validateSpec (Maven/Gradle) or --skip-validate-spec (CLI).
   | Error count: 1, Warning count: 0
  Errors: 
      -attribute definitions.Error.externalDocs is unexpected

for this valid swagger 2 excerption

definitions:
  Error:
    title: Error
    type: object
    description: Default error message template
    required:
      - id
      - code
      - timestamp
      - severity
    externalDocs:
      url: https://example.net/example
      description: Confluence page describing Error model

gynoro avatar Aug 02 '22 14:08 gynoro

+1

drej1 avatar Aug 08 '22 06:08 drej1

+1

MrJServices avatar Sep 19 '22 14:09 MrJServices

+1

roborobo2 avatar Sep 19 '22 14:09 roborobo2