Musisz użyć tego files
parametru, aby wysłać wieloczęściowe żądanie POST, nawet jeśli nie musisz przesyłać żadnych plików.
Z oryginalnego źródła żądań :
def request(method, url, **kwargs):
"""Constructs and sends a :class:`Request <Request>`.
...
:param files: (optional) Dictionary of ``'name': file-like-objects``
(or ``{'name': file-tuple}``) for multipart encoding upload.
``file-tuple`` can be a 2-tuple ``('filename', fileobj)``,
3-tuple ``('filename', fileobj, 'content_type')``
or a 4-tuple ``('filename', fileobj, 'content_type', custom_headers)``,
where ``'content-type'`` is a string
defining the content type of the given file
and ``custom_headers`` a dict-like object
containing additional headers to add for the file.
Odpowiednia część to: file-tuple can be a
2-tuple
, .3-tuple
or a
4-tuple
Na podstawie powyższego najprostsze wieloczęściowe żądanie formularza, które zawiera zarówno pliki do przesłania, jak i pola formularza, będzie wyglądać następująco:
multipart_form_data = {
'file2': ('custom_file_name.zip', open('myfile.zip', 'rb')),
'action': (None, 'store'),
'path': (None, '/path1')
}
response = requests.post('https://httpbin.org/post', files=multipart_form_data)
print(response.content)
☝ Zauważ None
jako pierwszy argument w krotce dla pól zwykłego tekstu - jest to symbol zastępczy pola nazwy pliku, który jest używany tylko do przesyłania plików, ale dla pól tekstowych przekazywanych, None
ponieważ pierwszy parametr jest wymagany do przesłania danych .
Wiele pól o tej samej nazwie
Jeśli musisz opublikować wiele pól o tej samej nazwie, zamiast słownika możesz zdefiniować ładunek jako listę (lub krotkę) krotek:
multipart_form_data = (
('file2', ('custom_file_name.zip', open('myfile.zip', 'rb'))),
('action', (None, 'store')),
('path', (None, '/path1')),
('path', (None, '/path2')),
('path', (None, '/path3')),
)
Interfejs API żądań przesyłania strumieniowego
Jeśli powyższy interfejs API nie jest dla Ciebie wystarczający w Pythonie, zastanów się nad użyciem żądania toolbelt ( pip install requests_toolbelt
), który jest rozszerzeniem podstawowego modułu żądań , który zapewnia obsługę przesyłania strumieniowego plików, a także MultipartEncoder, którego można użyć zamiast niego files
i który pozwala definiujesz ładunek jako słownik, krotkę lub listę.
MultipartEncoder
może być używany zarówno do żądań wieloczęściowych z lub bez rzeczywistych pól przesyłania. Musi być przypisany do data
parametru.
import requests
from requests_toolbelt.multipart.encoder import MultipartEncoder
multipart_data = MultipartEncoder(
fields={
# a file upload field
'file': ('file.zip', open('file.zip', 'rb'), 'text/plain')
# plain text fields
'field0': 'value0',
'field1': 'value1',
}
)
response = requests.post('http://httpbin.org/post', data=multipart_data,
headers={'Content-Type': multipart_data.content_type})
Jeśli musisz wysłać wiele pól o tej samej nazwie lub jeśli kolejność pól formularza jest ważna, zamiast słownika można użyć krotki lub listy:
multipart_data = MultipartEncoder(
fields=(
('action', 'ingest'),
('item', 'spam'),
('item', 'sausage'),
('item', 'eggs'),
)
)