Referenced responses are not rendered

[mbaumgartl]

I define some common responses and want to reference them in path endpoint(s):

swagger: "2.0"

info:
  title: Sample API
  version: 0.0.1

responses:
  ForbiddenError: # 403
    description: Access denied - additional privileges/rights required to retrieve item
    schema:
      $ref: '#/definitions/Error'
  NotFoundError: # 404
    description: Item not found
    schema:
      $ref: '#/definitions/Error'
  GeneralError: # 500
    description: Unrecoverable error - something really bad happened :-(
    schema:
      $ref: '#/definitions/Error'

paths:
  /article/{articleId}:
    get:
      description: Retrieve single article
      parameters:
        - name: articleId
          in: path
          required: true
          type: integer
          format: int64
      responses:
        200:
          description: Article
          schema:
            type: object
        403:
          $ref: '#/responses/ForbiddenError'
        404:
          $ref: '#/responses/NotFoundError'
        500:
          $ref: '#/responses/GeneralError'

definitions:
  Error:
    type: object
    properties:
      message:
        type: string

The editor renders referenced responses while Swagger-UI doesn't.

[mohsen1]

This is probably fixed by the new swagger-js issue. I'll confirm it today

[fehguy]

let's add a test around this and close it after verification

[mohsen1]

Fixed in develop_2.0 branch at 3de0b36

[mbaumgartl]

@mohsen1: Sorry, but I don't see the issue fixed. Neither description nor model is rendered for referenced responses. I opened this issue because I had the same output (I should have attached a screenshot).

[mohsen1]

hmmm... I see all the responses but apparently their contents are empty. It's an issue in swagger-js. Follow the issue here:

swagger-api/swagger-js#329

[fehguy]

confirmed fixed from swagger-api/swagger-js@893eb99

[mbaumgartl]

Thanks for fixing the issue quickly! +1