Python使用requests发送multipart/form-data类型Excel文件详解

小岛来信
小岛来信
发布时间:2026-10-12 | 2人浏览过
原创

本文详解Python中如何使用requests库发送multipart/form-data类型的Excel数据。通过对比application/x-www-form-urlencoded与multipart/form-data的区别,重点介绍利用requests_toolbelt.MultipartEncoder构造请求头及文件对象的方法,并提供完整的代码示例实现Excel文件的POST上传。

Python使用requests.post方法传递form-data类型的Excel数据

import datetime
import json
import random
import string
import requests
from requests_toolbelt import MultipartEncoder
# 在企业微信群里发消息
def log(day):
	url = 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx'
	headers = {
		"Content-Type":"application/json"
	}
	data = {
		"msgtype":"text",
		"text":{
			"content":"xxx"
		}
	}
	response = requests.post(url=url,headers=headers,data=json.dumps(data))
	print(response.status_code)
	print(response.text)
# 测试环境
# url = "https://xxx"
# 生产环境
url = "https://xxx"
# 定义字符集
chars = string.ascii_lowercase+string.digits+string.ascii_uppercase
# 生成长度为32的随机字符串
random_str = ''.join(random.sample(chars, 32))
print(random_str)
# 设置日期
day = ((datetime.datetime.now()-datetime.timedelta(days=1)).strftime("%Y-%m-%d"))
# 配置数据
data = MultipartEncoder({
	'requestId':random_str,
	'docType':'invoice',
	# 'application/octet-stream'这个可以通过apifox等软件post一次后看请求内容获取
	'file': ('xxx.csv', open('xxx.csv', 'rb'), 'application/octet-stream'),
	# 'file': ('xxx.csv'), open(xxx.csv', 'rb'), 'application/octet-stream'),
})
# 配置请求头
headers = {
   # 'Authorization': 'Bearer xxx',    # 测试环境
   'Authorization': 'Bearer xxx',  # 生产环境
   'User-Agent': 'Apifox/1.0.0 (https://apifox.com)',
   'Accept': '*/*',
   # 'Host': 'xxx',   # 测试环境
   'Host': 'xxx',     # 生产环境
   'Connection': 'keep-alive',
   'Content-Type': data.content_type
}
print(data.content_type)
# 返回结果
response = requests.post(url, headers=headers, data=data)
print(response.text)
if json.loads(response.text)['code'] == "200":
	print("ok")
	log(day)

补充说明:

Python使用requests发送post请求并处理form-data类型数据

部分POST接口要求发送multipart/form-data格式的数据,那么如何使用Python的requests库来模拟此类请求呢?

依据HTTP/1.1 RFC 2616协议规范,常见的请求方法包括OPTIONS、GET、HEAD、POST、PUT、DELETE和TRACE等。

HTTP协议基于ASCII码传输,构建于TCP和IP协议之上。该规范将HTTP请求划分为三个部分:状态行、请求头和请求体。所有方法的具体实现均围绕如何组织这三部分展开,核心逻辑不变。

POST请求主要支持两种编码格式:application/x-www-form-urlencoded和multipart/form-data。

  • application/x-www-form-urlencoded常用于前端表单提交,其参数格式为key=value&key=value。
  • 若参数包含特殊字符,需进行URL编码,采用的编码格式即为application/x-www-form-urlencoded(规则:键值对参数以&连接;空格转换为+号;特殊符号转换为ASCII HEX值)。例如,若参数值中包含&,需转换为ASCII HEX值%26,对应ASCII码中38位置的&符号。
  • application/x-www-form-urlencoded是浏览器默认的编码格式。对于GET请求,参数会被转换为?key=value&key=value格式并附加在URL之后。

multipart/form-data

multipart/form-data格式不仅支持传输普通参数,还支持文件传输。该格式由POST请求演变而来,具体细节如下:

  • multipart/form-data的基础方式是POST,即基于POST请求实现。
  • multipart/form-data与普通POST方法的主要区别在于请求头和请求体的构造。
  • multipart/form-data的请求头必须包含特殊的Content-Type信息,其值必须为multipart/form-data;同时还需指定一个内容分割符(boundary)用于分隔请求体中不同的参数内容。具体的头信息格式如下:Content-Type: multipart/form-data; boundary=${bound}。
  • multipart/form-data的请求体同样为字符串,但其构造方式与普通POST不同。普通POST请求仅连接简单的键值对,而multipart/form-data则在构造体中添加了分隔符、参数描述信息等复杂内容。

关于boundary(边界):

  • 前文提到普通POST请求使用&来分隔参数,那么服务器在处理multipart/form-data格式格式的POST请求时,采用何种方式分割参数呢?答案是boundary。
  • 从相关图示可以看出,HTTP Body中使用两个短横线“--”加上boundary字符串来分割不同参数。无论是值参数(Value)还是文件参数(File),在Boundary内部均包含独立的描述信息,并非URL参数的简单迁移。

在请求结束时,前缀需添加双短横线,后缀也需添加双短横线,以此代表请求结束。

boundary常见问题解答:

问:boundary的值是否可以由用户自由定义? 答:可以,但为了避免与正常文本内容重复,建议尽量使用较为复杂的内容。

问:boundary的作用是什么? 答:用于分割参数,其功能类似于普通POST请求中的&符号。

使用Python发送multipart/form-data类型数据

主要有两种实现方式:

  • 手动组建form-data并修改headers
  • 通过files参数传递form-data,推荐采用此种方式,本文仅介绍该方法。

在官方网站文档中,requests模拟表单数据的格式如下:

files = {name: (<filename>, <file object>, <content type>, <per-part headers>)}

上述代码模拟生成的POST数据内容如下:

Content-Disposition: form-data; name={name};filename=<filename> Content-Type: <content type> <file object> --boundary

注意:如果未指定filename和content-Type,生成的模拟POST数据中将不包含这两项信息。

基于上述说明,构造好files字典后,直接发起POST请求即可发送数据:

files = {
    'schoolId': (None, -1),
    'schoolName': (None, ""),
    "reward": (None, 5),
    "publishText": (None, "测试测试"),
    "tags": (None, 1),
    'image': ('image.jpg', open('%s/resource/upload_images/image.jpg' % PATH_DIR, 'rb'), 'application/octet-stream')
}
response = requests.post(url, files=files)

猪猪侠要努力呀!

至此,关于Python使用requests.post方法传递form-data类型Excel数据的介绍已结束,更多相关Python使用requests传递Excel数据的内容请搜索本站历史文章或继续浏览后续文章,希望大家以后多多支持本站!

相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表