如何在Python中编写接口和请求外部接口
一、引入requests库
Python是通过requests库来请求接口的，所以，首先需要通过pip安装requests库。
pip install requests==2.21.0 #文件上传才会用 pip install requests-toolbelt==0.9.1
说明：本文编写的接口用到的是Flask框架关于Flask框架的使用请参考
二、Get请求
这里以微信授权的接口为例。
接口文档如下：
这是一个通过Get方式请求的接口，返回类型是application/json，
所以请求的代码是：
# 引入库
import requests,json
url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=123&secret=345"
# 请求接口
res = requests.get(url)
#对返回的内容进行编码
content = res.content.decode('utf-8')
#将json字符串反序列化
tokenJson = json.loads(content)
access_token = tokenJson['access_token']
代码解释：
res = requests.get(url)就是发起Get请求，获取响应值。content = res.content.decode('utf-8')因为res.content默认的类型是bytes类型的，所以需要进行解码转成str类型。只有转化之后才能被正确的反序列化。tokenJson = json.loads(content)就是将Json字符串反序列了成字典，这个对象是一个dict，
python与json的数据类型对应关系如下图所示：
4.access_token = tokenJson['access_token']获取key为access_token的token值。
三、Post请求
Post请求方法同样是一个非常常用的请求方法。
Post请求的请求类型有三种：
application/x-www-form-urlencoded这是以form表单的方式来提交post请求。application/json;charset=utf-8这是以json字符串的格式，将请求参数放在RequestBody中的方式。form-data这种方式一般是用来上传文件用的。
下面分别就这三种请求方式来编写请求代码
1.以form表单提交的方式
请求方：
def post_form_urlencoded():
url = "http://127.0.0.1:8080/v1/ls/voice/save"
data = {"dst_audio": "9d62ca66-326f-4070-9993-5f89f790dc68.wav"}
res = requests.post(url, data)
content = res.content.decode('utf-8')
print(content)
以form表单提交的post请求，只需要把请求参数封装到一个字典dict中进行传入就可以了。这里传入了一个名为dst_audio的参数。不需要设置Content-Type。
如果我们的请求的接口的域名是https的地址的话，直接这样写的话会报SSLError: HTTPSConnectionPool的问题。
解决的方法是：
res = requests.post(url, data=data, verify=False)
将verify参数设置为False。也就是不检查SSL证书。
接收方：
@ma.route('/v1/ls/voice/save', methods=['POST'])
def save():
group_uuid = uuid.uuid1()
dst_audio = request.values.get('dst_audio')
my_data = {
"video_id": group_uuid
}
return jsonify({'code': 0, 'msg': "保存成功", 'data': json_data})
接收Form表单中的参数只需要通过request.values.get(参数名) 来获取。多个参数分别获取。route里定义了接口的路由地址，methods属性指定接口的请求方法。其中jsonify函数是将dict序列化成json字符串，是flask框架的一个函数。
2.以json字符串的格式来提交
请求方：
def post_json():
url = "http://127.0.0.1:8080/v1/ls/json"
x_header = {
'Content-Type': 'application/json; charset=utf-8',
}
body = json.dumps({"name": "张三", "age": 12})
res = requests.post(url, data=body, headers=x_header, timeout=10)
content = res.content.decode('utf-8')
print(content)
application/json请求类型的接口，需要将请求参数通过json.dumps方法序列化成一个Json字符串传入给接口，然后，在请求头中指定Content-Type为application/json; charset=utf-8。
调用post方法requests.post(url, data=body, headers=x_header) 。其中：data 指定请求参数，headers指定请求头。timeout 是指定超时时间是10秒
接收方：
@ma.route('/v1/ls/json', methods=['POST'])
def post_json():
if request.method == 'POST':
json_data_str = request.get_data().decode('utf-8')
json_data = json.loads(json_data_str)
return jsonify({'code': 0, 'msg': "请求成功", 'data': json_data})
接收请求体中参数只需要调用request.get_data().decode('utf-8')方法，这里必须要将其解码，不然，中文会被编码{"name": "\\u5f20\\u4e09", "age": 12}。
3.文件上传
请求方：
from requests_toolbelt.multipart.encoder import MultipartEncoder
def post_form_data():
post_url = "http://127.0.0.1:8080/v1/ls/upload"
headers = {}
multipart_encoder = MultipartEncoder(
fields={
'file': (os.path.basename('D:\\test.txt'), open('D:\\test.txt', 'rb'), 'application/octet-stream'),
'file_name': '张三'
}
)
headers['Content-Type'] = multipart_encoder.content_type
post_response = requests.post(post_url, data=multipart_encoder, headers=headers, verify=False)
content = post_response.content.decode('utf-8')
print(content)
form-data请求类型的接口，一般是文件上传的接口，我们可以将参数封装到MultipartEncoder对象中，在fields中定义一个字典，在这个字典中传入多个参数。其中 file 参数指定需要上传的文件，通过open('D:\\test.txt', 'rb')方法读取文件的内容。并指定请求类型为application/octet-stream。file是参数名称，需要按照接口方的定义传入。
接收方：
@ma.route('/v1/ls/upload', methods=['POST'])
def post_form_data():
temp_file = request.files['file']
file_name = request.values.get('file_name')
file_path = os.path.abspath('.') + "/" + "temp.txt"
temp_file.save(file_path)
return jsonify({'code': 0, 'msg': "请求成功", 'data': file_path})
文件上传的接口接收文件是通过request.files['file']方式来接收的。
三个接口的请求结果如下图：
四、总结
本文详细介绍了Python中通过requests库来请求外部接口，按照请求方法分为get请求和post请求。post请求的按照请求类型又分为application/x-www-form-urlencoded，application/json以及form-data 这三种。这三种的请求大同小异，只是传参不同而已，当请求类型是application/x-www-form-urlencoded 时请求参数封装到dict中传入，当请求类型是application/json时传入的请求参数需要时一个json字符串。当请求类型是form-data时，可以将请求参数封装到MultipartEncoder对象中。
