引言
Flask 是一个简单且十分强大的Python web 框架。它被称为微框架,“微”并不是意味着把整个Web应用放入到一个Python文件,微框架中的“微”是指Flask旨在保持代码简洁且易于扩展,Flask框架的主要特征是核心构成比较简单,但具有很强的扩展性和兼容性,程序员可以使用Python语言快速实现一个网站或 Web服务。因此flask能很方便构建一个web服务,给外部也可以叫做客户端提供web服务,针对flask框架这种特点我们可以很容易构建API接口,供客户端访问。
Flask接口开发示例
首先安装需要的Flask模块,如果你的环境已经安装了pip则键入:pip install flask即可安装完成
1.1 构建GET请求方法的接口
在Pycharm中新建py文件,编辑如下代码
# -*- coding: utf-8 -*-
import flask,json
import time
server = flask.Flask(__name__) # 创建一个服务,把当前这个python文件当做一个服务
@server.route('/VIID/System/Time', methods=['get']) # @server.route()可以将普通函数转变为服务、接口的路径、请求方式,如果不写methods则默认get方法
def Time():
'''查询字符串:无,消息体:无,返回结果:SystemTime'''
response_data = {
"SystemTimeObject": {
"VIIDServerID": "123",
"TimeMode": "1",
"LocalTime": time.strftime('%Y%m%d%H%M%S', time.localtime(time.time())),
}
}
return json.dumps(response_data, ensure_ascii=False)
if __name__ == '__main__':
server.run(debug=True, port=5000, host='10.82.25.11') # 指定访问端口、host
然后运行该py文件,则该文件运行在本地就是一个web服务,用浏览器或者postman尝试访问该服务的URL即可
浏览器访问:
postman发请求访问:
浏览器或者postman请求完成后,在Pycharm的输出栏会输出如下:
其它的请求如POST、PUT、DELETE等方法,在methods参数中指明即可,不过POST、PUT、DELETE等方法不能由浏览器直接访问,因为浏览器默认访问时是get方法,可以用postman按指定的方法发请求
1.2 获取带json格式请求体的接口
有时客户端发送的请求是带json格式的,这时需要获取请求的json,编辑代码如下:
@server.route('/data',methods=['post'])
def post_json():
if flask.request.is_json:
print(flask.request.json)
name = flask.request.json.get('name') # 获取json请求体的第一个参数的值
age = flask.request.json.get('age') # 获取json请求体的第二个参数的值
data = {'name':name,'age':age}
return json.dumps(data,ensure_ascii=False)
else:
return json.dumps({'msg':'请传json格式参数'},ensure_ascii=False)
使用postman作为客户端发送带json请求体的请求,如下图:
1.3 获取get请求中发送的参数
flask提供的方法是:
value = flask.request.args.get('name') # 获取get请求参数name的值
1.4 构建动态URL以及响应体的重定向
很多时候,客户端请求的url是变化的,也就是带有动态参数的,flask也是可以轻松的构建提供动态参数的url资源服务并重定向响应体,代码如下:
# -*- coding: utf-8 -*-
import flask,json
from flask import url_for,redirect
server = flask.Flask(__name__) # 创建一个服务,把当前这个python文件当做一个服务
@server.route('/data')
def data(): # 返回data
data = {
'VideoSliceInfoObject': {
'VideoID': 'esse elit',
'AudioCodeFormat': 'commodo'
}
}
return json.dumps(data, ensure_ascii=False)
@server.route('/data//Info', methods=['post'])
def data_redirect(ID):
return redirect(url_for('data', guest=ID))
if __name__ == '__main__':
server.run(debug=True, port=5000, host='10.82.25.11') # 指定访问端口、host
后面无论postman或者客户端发送的url中的ID参数是啥,都可以响应
1.5 重新构建响应头和响应状态码
有时在与第三方系统对接时,需要返回携带响应头消息和指定的响应状态码,在flask中也是可以构建自定义的响应消息的
# -*- coding: utf-8 -*-
import flask,json
server = flask.Flask(__name__) # 创建一个服务,把当前这个python文件当做一个服务
@server.route('/data',methods=['post'])
def post_json():
if flask.request.is_json:
print(flask.request.json)
name = flask.request.json.get('name') # 获取json请求体的第一个参数的值
age = flask.request.json.get('age') # 获取json请求体的第二个参数的值
data = {'name':name,'age':age}
# 构建响应头域和状态码
resp = flask.make_response(json.dumps(data, ensure_ascii=False))
resp.status = "666"
resp.headers[
"python"] = "python flask"
return resp
else:
return json.dumps({'msg':'请传json格式参数'},ensure_ascii=False)
if __name__ == '__main__':
server.run(debug=True, port=5000, host='10.82.25.11') # 指定访问端口、host
运行该py文件,在postman中发送请求,查看响应信息,如下图,变成的我们自定义设置的响应头和状态码
这样我们就完全自定义了响应的头和状态码