From 53f33eb473ec55746098670d178e1e1936003da6 Mon Sep 17 00:00:00 2001 From: Tom S Date: Tue, 3 Feb 2015 09:16:38 +0000 Subject: [PATCH] quickstart: using a list as a value in query params --- docs/user/quickstart.rst | 7 +++++++ 1 file changed, 7 insertions(+) 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 ---------------- -- 2.34.1