需求场景
在api设计中,基于restful的设计原则,一个http的响应应该包含执行的响应信息以及状态码。
例如:一个错误信息的响应信息应该包含内容以及返回对应的设计错误码。
在flask中如何制定这个的响应信息呢?下面来看看。
使用return直接设置特定的响应信息
return 响应体, 状态码, 响应头
等价于
return (响应体, 状态码, 响应头)
return 可以返回一个元组,这样的元组必须是 (response, status, headers) 的形式,且至少包含一个元素。 status 值会覆盖状态代码, headers 可以是一个列表或字典,作为额外的消息标头值。
下面写个示例视图函数如下:
from flask import Flask, request, abort
# 实例化app
app = Flask(import_name=__name__)
@app.route('/login', methods=["GET","POST"])
def login():
# return 响应体, 状态码, 响应头
return "login fail", 404, [("token", "123456"), ("City", "shenzhen")] # 使用元组的方式设置header
if __name__ == '__main__':
app.run(debug=True)
使用浏览器请求如下:
return "login fail", 404, [("token", "123456"), ("City", "shenzhen")]
可以看到上面设置响应消息成功返回。
- status 值可以设置任意的状态代码,headers可以是字典
from flask import Flask, request, abort
# 实例化app
app = Flask(import_name=__name__)
@app.route('/login', methods=["GET","POST"])
def login():
# return 响应体, 状态码, 响应头
# return "login fail", 404, [("token", "123456"), ("City", "shenzhen")] # 使用元组的方式设置header
return "login fail", "666 hello wolrd", {"token":"123456", "City": "shenzhen"} # 使用元组的方式设置header
if __name__ == '__main__':
app.run(debug=True)
使用浏览器请求如下:
- 响应消息元组 (response, status, headers) 至少包含一个元素
from flask import Flask, request, abort
# 实例化app
app = Flask(import_name=__name__)
@app.route('/login', methods=["GET","POST"])
def login():
# return 响应体, 状态码, 响应头
# return "login fail", 404, [("token", "123456"), ("City", "shenzhen")] # 使用元组的方式设置header
# return "login fail", "666 hello wolrd", {"token":"123456", "City": "shenzhen"} # 使用元组的方式设置header
return "login fail", "999 hello wolrd"
if __name__ == '__main__':
app.run(debug=True)
使用浏览器请求如下:
可以看到只要至少有一项作为响应消息即可。
除了return的方式返回特性的响应消息,还可以使用另一种方式。
使用make_response设置特定的响应信息
导入make_response
from flask import make_response
示例代码如下:
from flask import Flask, request, abort, make_response
# 实例化app
app = Flask(import_name=__name__)
@app.route('/login', methods=["GET","POST"])
def login():
res = make_response("login fail") # 设置响应体
res.status = '999 login fail' # 设置状态码
res.headers['token'] = "123456" # 设置响应头
res.headers['City'] = "shenzhen" # 设置响应头
return res
if __name__ == '__main__':
app.run(debug=True)
在浏览器执行如下: