1、需要的環境
Python
Requests 庫
2、單字段發送單個文件
在requests中發送文件的接口只有一種,那就是使用requests.post的files參數, 請求形式如下:
url = "http://httpbin.org/post"
data = None
files = { ... }
r = requests.post(url, data, files=files)
而這個files參數是可以接受很多種形式的數據,最基本的2種形式為:
字典類型
元組列表類型
2.1、字典類型的files參數
官方推薦使用的字典參數格式如下:
{
"field1" : ("filename1", open("filePath1", "rb")),
"field2" : ("filename2", open("filePath2", "rb"), "image/jpeg"),
"field3" : ("filename3", open("filePath3", "rb"), "image/jpeg", {"refer" : "localhost"})
}
這個字典的key就是發送post請求時的字段名, 而字典的value則描述了准備發送的文件的信息;從上面可以看出value可以是2元組,3元組或4元組;
這個元組的每一個字段代表的意思一次為:
("filename", "fileobject", "content-type", "headers")
缺省的話則會使用默認值
除了上面的使用形式,其實requests還是支持一個更簡潔的參數形式,如下
{
"field1" : open("filePath1", "rb")),
"field2" : open("filePath2", "rb")),
"field3" : open("filePath3", "rb"))
}
這種形式的參數其等同效果如下, 其中filename是filepath的文件名:
{
"field1" : ("filename1", open("filePath1", "rb")),
"field2" : ("filename2", open("filePath2", "rb")),
"field3" : ("filename3", open("filePath3", "rb"))
}
當然,你還可以這樣發送一個文件請求
{
"field1" : open("filePath1", "rb").read())
}
這里的filename的值為field1
2.2、元組列表類型的files參數
其實元組列表的形式與字典的形式基本一樣,除了最外層的包裝不一樣;而在requests內部最終會把字典參數形式 轉換 為 元組列的形式。官網推薦的用法如下:
[
("field1" : ("filename1", open("filePath1", "rb"))),
["field2" : ("filename2", open("filePath2", "rb"), "image/jpeg")],
("field3" : ("filename3", open("filePath3", "rb"), "image/jpeg", {"refer" : "localhost"}))
]
列表里面的子項可以是元組,也可以是列表;同樣這里也支持簡介的形式,如下:
[
("field1" : open("filePath1", "rb"))), ##filename 使用的是filepath的文件名
("field2" : open("filePath2", "rb").read())) ##filename 使用的是鍵值,即 field2
]
3、單字段發送多個文件【即上傳文件時,設置為多選了】
3.1、字典參數形式
{
"field1" : [
("filename1", open("filePath1", "rb")),
("filename2", open("filePath2", "rb"), "image/png"),
open("filePath3", "rb"),
open("filePath4", "rb").read()
]
}
3.2、元組列表形式
[
("field1" , ("filename1", open("filePath1", "rb"))),
("field1" , ("filename2", open("filePath2", "rb"), "image/png")),
("field1" , open("filePath3", "rb")),
("field1" , open("filePath4", "rb").read())
]
上面2種形式發送的請求,所有的文件都會在同一個字段下,后台服務只要從field1字段就可以獲取全部的文件對象
4、同時發送普通數據字段
上面介紹的是使用發送文件內容請求,而有時候我們在發送文件的同時還需要發送普通的數據字段,此時普通數據字段直接存在data參數中即可,如下:
data = {"k1" : "v1"}
files = {
"field1" : open("1.png", "rb")
}
r = requests.post("http://httpbin.org/post", data, files=files)