Postman and Swagger 2.0 compatibility issue

Ask the Experts and Postman Tips
, ,
1

Hi Team,

I have encountered a situation, where if I specify any members other than “$ref” under schema, the postman will catch it as a syntactical error where as the specification says “Any members other than “$ref” in a JSON Reference object SHALL be ignored”. Due to this syntactical error postman couldn’t able to load the API documentation.

e.g. Following responses object will give the syntactical error “contains invalid property: description” where as it should be ignored and should not give any syntactical error.

responses:
    '200':
      description: Success
      headers: {}
      schema:
        $ref: '#/definitions/mydefinition'
        description: 'Request successful'

Is it a bug in the postman? If so is there any bug reported? I am using swagger 2.0

2

Thanks for your post, and sorry we didn’t get to this sooner. This isn’t the experience we want for our users.

Since the post is a bit older, we’re closing it to make room for newer discussions. If you’re still experiencing this or have new details to share, we’d love for you to start a new discussion.