Add response headers to response model

[mohsen1]

Swagger UI needs response headers in response object model under headers property.

Related: swagger-api/swagger-ui#1000

[fehguy]

you can get sample response headers from the petstore api now:

http://petstore.swagger.io/v2/swagger.json

[whitlockjc]

I think he means the response object from SwaggerHttp.

[whitlockjc]

@mohsen1 Can you tell me which fields you use in the response object? I see some duplication in what is there now and would like to know what you're using.

[fehguy]

I thought i replied to this. There is a response header definition in the spec, which should be part of the "model" returned by each operation. That's different from what response headers actually come back from the server.

[whitlockjc]

I was wrong. I misunderstood.

[whitlockjc]

After being in the SwaggerHttp code recently and seeing now official response model structure, I thought that was the response he was referring to. But after looking at the code he pointed me to, I had just figured this out when you commented.

[whitlockjc]

This should be fixed.

[whitlockjc]

The fix for this does not support references. References are broken in most of swagger-js and will be addressed together.