' 'as part of the request.') raise falcon.HTTPUnauthorized(title='Auth token required', description=description, 'Please request a new token and try again.') raise falcon.HTTPUnauthorized(title='Authentication required', description=description, not in req.content_type: raise falcon.HTTPUnsupportedMediaType( title='This API only supports requests encoded as JSON.', href='http://docs.examples

' 'as part of the request.') raise falcon.HTTPUnauthorized(title='Auth token required', description=description, 'Please request a new token and try again.') raise falcon.HTTPUnauthorized(title='Authentication required', description=description, not in req.content_type: raise falcon.HTTPUnsupportedMediaType( title='This API only supports requests encoded as JSON.', href='http://docs.examples

' 'as part of the request.') raise falcon.HTTPUnauthorized(title='Auth token required', description=description, 'Please request a new token and try again.') raise falcon.HTTPUnauthorized(title='Authentication required', description=description, not in req.content_type: raise falcon.HTTPUnsupportedMediaType( title='This API only supports requests encoded as JSON.', href='http://docs.examples

' 'as part of the request.') raise falcon.HTTPUnauthorized(title='Auth token required', description=description, 'Please request a new token and try again.') raise falcon.HTTPUnauthorized(title='Authentication required', description=description, not in req.content_type: raise falcon.HTTPUnsupportedMediaType( title='This API only supports requests encoded as JSON.', href='http://docs.examples

to read more bytes than are expected (as determined by the Content-Length header) may or may not block indefinitely. It’s a good idea to test your WSGI server to find out how it behaves. This can be particulary verbose: # If Content-Length happens to be 0, or the header is # missing altogether, this will not block. data = req.stream.read(req.content_length or 0) Alternatively, when passing the stream directly the body, and will never block on out-of-bounds reads, assuming the client does not stall while transmitting the data to the server. For example, the following will not block when Content-Length is 0

description = ('Please provide an auth token ' 'as part of the request.') raise falcon.HTTPUnauthorized(title='Auth token required', description=description, challenges=challenges, href='http://docs.example.com/auth') token is not valid. ' 'Please request a new token and try again.') raise falcon.HTTPUnauthorized(title='Authentication required', description=description, challenges=challenges, href='http://docs.example 'PUT'): if 'application/json' not in req.content_type: raise falcon.HTTPUnsupportedMediaType( title='This API only supports requests encoded as JSON.', href='http://docs.examples.com/api/json') class

description = ('Please provide an auth token ' 'as part of the request.') raise falcon.HTTPUnauthorized(title='Auth token required', description=description, challenges=challenges, href='http://docs.example.com/auth') token is not valid. ' 'Please request a new token and try again.') raise falcon.HTTPUnauthorized(title='Authentication required', description=description, challenges=challenges, href='http://docs.example 'PUT'): if 'application/json' not in req.content_type: raise falcon.HTTPUnsupportedMediaType( title='This API only supports requests encoded as JSON.', href='http://docs.examples.com/api/json') class

description = ('Please provide an auth token ' 'as part of the request.') raise falcon.HTTPUnauthorized(title='Auth token required', description=description, challenges=challenges, href='http://docs.example.com/auth') token is not valid. ' 'Please request a new token and try again.') raise falcon.HTTPUnauthorized(title='Authentication required', description=description, challenges=challenges, href='http://docs.example 'PUT'): if 'application/json' not in req.content_type: raise falcon.HTTPUnsupportedMediaType( title='This API only supports requests encoded as JSON.', href='http://docs.examples.com/api/json') class

description = ('Please provide an auth token ' 'as part of the request.') raise falcon.HTTPUnauthorized(title='Auth token required', description=description, challenges=challenges, href='http://docs.example.com/auth') token is not valid. ' 'Please request a new token and try again.') raise falcon.HTTPUnauthorized(title='Authentication required', description=description, challenges=challenges, href='http://docs.example 'PUT'): if 'application/json' not in req.content_type: raise falcon.HTTPUnsupportedMediaType( title='This API only supports requests encoded as JSON.', href='http://docs.examples.com/api/json') class

Either a file-like object with a read() method that takes an optional size argument and returns a block of bytes, or an iterable object, representing response content, and yielding blocks as byte strings objects. stream_len int – Expected length of stream (e.g., file size). add_link(target, rel, title=None, title_star=None, anchor=None, hreflang=None, type_hint=None)[source] Add a link header to the response relation types. Kwargs: title (str): Human-readable label for the destination of the link (default None). If the title includes non-ASCII characters, you will need to use title_star instead, or provide