falconry / falcon

The no-magic web data plane API and microservices framework for Python developers, with a focus on reliability, correctness, and performance at scale.
https://falcon.readthedocs.io/en/stable/
Apache License 2.0
9.51k stars 937 forks source link

Clarify response header behavior in the case of a redirect #1920

Open kgriffs opened 3 years ago

kgriffs commented 3 years ago

Clarify the docs re this comment in chat from a community member:

Hi everyone - I have a documentation question - https://falcon.readthedocs.io/en/2.0.0/api/redirects.html What does "headers" parameters do in these exceptions? Merge with original request headers? Replace them?

A.

the headers that are merged are the ones set in the response, not the original request ones https://github.com/falconry/falcon/blob/871d6bbe5b76d63fddae566b2682b321603af06b/falcon/app.py#L930-L953