From: Tom S <scytale@gmail.com>
Date: Tue, 3 Feb 2015 09:16:38 +0000 (+0000)
Subject: quickstart: using a list as a value in query params
X-Git-Tag: v2.5.2~8^2
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=53f33eb473ec55746098670d178e1e1936003da6;p=services%2Fpython-requests.git

quickstart: using a list as a value in query params
---

diff --git a/docs/user/quickstart.rst b/docs/user/quickstart.rst
index b501b1b..febcf8c 100644
--- a/docs/user/quickstart.rst
+++ b/docs/user/quickstart.rst
@@ -73,6 +73,13 @@ You can see that the URL has been correctly encoded by printing the URL::
 Note that any dictionary key whose value is ``None`` will not be added to the
 URL's query string.
 
+In order to pass a list of items as a value you must mark the key as
+referring to a list like string by appending ``[]`` to the key::
+
+    >>> payload = {'key1': 'value1', 'key2[]': ['value2', 'value3']}
+    >>> r = requests.get("http://httpbin.org/get", params=payload)
+    >>> print(r.url)
+    http://httpbin.org/get?key1=value1&key2%5B%5D=value2&key2%5B%5D=value3
 
 Response Content
 ----------------