ファイルをアップロードする必要がない場合でもfiles
、このパラメーターを使用してマルチパートフォームのPOSTリクエストを送信する必要があります。
元のリクエストソースから:
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.
関連する部分は次のとおりです。 file-tuple can be a
2-tuple
、。3-tuple
or a
4-tuple
上記に基づいて、アップロードするファイルとフォームフィールドの両方を含む最も単純なマルチパートフォームリクエストは次のようになります。
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)
☝ 注None
プレーンテキストフィールドのタプルの最初の引数として-これは、ファイルのアップロードのために使用されるファイル名フィールドのプレースホルダであるが、テキストフィールドに渡すNone
最初のパラメータは、データが送信されるために必要とされます。
同じ名前の複数のフィールド
同じ名前の複数のフィールドを投稿する必要がある場合は、辞書の代わりに、ペイロードをタプルのリスト(またはタプル)として定義できます。
multipart_form_data = (
('file2', ('custom_file_name.zip', open('myfile.zip', 'rb'))),
('action', (None, 'store')),
('path', (None, '/path1')),
('path', (None, '/path2')),
('path', (None, '/path3')),
)
ストリーミングリクエストAPI
上記のAPIが十分にpythonicでない場合は、拡張機能であるリクエストツールベルト(pip install requests_toolbelt
)の使用を検討してください。コア要求だけでなく、ストリーミングファイルアップロードのサポートを提供するモジュールMultipartEncoderの代わりに使用することができfiles
、かつこれもできますペイロードは、辞書、タプル、またはリストとして定義します。
MultipartEncoder
実際のアップロードフィールドの有無にかかわらず、マルチパートリクエストの両方に使用できます。に割り当てる必要がありますdata
パラメータにます。
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})
同じ名前の複数のフィールドを送信する必要がある場合、またはフォームフィールドの順序が重要な場合は、辞書の代わりにタプルまたはリストを使用できます。
multipart_data = MultipartEncoder(
fields=(
('action', 'ingest'),
('item', 'spam'),
('item', 'sausage'),
('item', 'eggs'),
)
)