1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
|
Metadata-Version: 1.1
Name: httpbin
Version: 0.5.0
Summary: HTTP Request and Response Service
Home-page: https://github.com/Runscope/httpbin
Author: Runscope
Author-email: httpbin@runscope.com
License: MIT
Description: httpbin(1): HTTP Request & Response Service
===========================================
Freely hosted in `HTTP <http://httpbin.org>`__,
`HTTPS <https://httpbin.org>`__ & `EU <http://eu.httpbin.org/>`__
flavors by `Runscope <https://www.runscope.com/>`__
|Deploy|_
.. |Deploy| image:: https://www.herokucdn.com/deploy/button.svg
.. _Deploy: https://heroku.com/deploy?template=https://github.com/runscope/httpbin
|Build Status|
ENDPOINTS
---------
====================================== ==================================================================================================================
Endpoint Description
-------------------------------------- ------------------------------------------------------------------------------------------------------------------
`/`_ This page.
`/ip`_ Returns Origin IP.
`/user-agent`_ Returns user-agent.
`/headers`_ Returns header dict.
`/get`_ Returns GET data.
`/post` Returns POST data.
`/patch` Returns PATCH data.
`/put` Returns PUT data.
`/delete` Returns DELETE data
`/gzip`_ Returns gzip-encoded data.
`/deflate`_ Returns deflate-encoded data.
`/status/:code`_ Returns given HTTP Status code.
`/response-headers`_ Returns given response headers.
`/redirect/:n`_ 302 Redirects *n* times.
`/redirect-to?url=foo`_ 302 Redirects to the *foo* URL.
`/redirect-to?url=foo&status_code=307`_ 307 Redirects to the *foo* URL.
`/relative-redirect/:n`_ 302 Relative redirects *n* times.
`/cookies`_ Returns cookie data.
`/cookies/set?name=value`_ Sets one or more simple cookies.
`/cookies/delete?name`_ Deletes one or more simple cookies.
`/basic-auth/:user/:passwd`_ Challenges HTTPBasic Auth.
`/hidden-basic-auth/:user/:passwd`_ 404'd BasicAuth.
`/digest-auth/:qop/:user/:passwd`_ Challenges HTTP Digest Auth.
`/stream/:n`_ Streams *n* – 100 lines.
`/delay/:n`_ Delays responding for *n* – 10 seconds.
`/drip`_ Drips up to 10MB data over a duration after an optional initial delay, then (optionally) returns with the given status code.
`/range/:n`_ Streams *n* bytes, and allows specifying a *Range* header to select a subset of the data. Accepts a *chunk\_size* and request *duration* parameter.
`/html`_ Renders an HTML Page.
`/robots.txt`_ Returns some robots.txt rules.
`/deny`_ Denied by robots.txt file.
`/cache`_ Returns 200 unless an If-Modified-Since or If-None-Match header is provided, when it returns a 304.
`/cache/:n`_ Sets a Cache-Control header for *n* seconds.
`/bytes/:n`_ Generates *n* random bytes of binary data, accepts optional *seed* integer parameter.
`/stream-bytes/:n`_ Streams *n* random bytes of binary data, accepts optional *seed* and *chunk\_size* integer parameters.
`/links/:n`_ Returns page containing *n* HTML links.
`/forms/post`_ HTML form that submits to */post*
`/xml`_ Returns some XML
`/encoding/utf8`_ Returns page containing UTF-8 data.
====================================== ==================================================================================================================
.. _/user-agent: http://httpbin.org/user-agent
.. _/headers: http://httpbin.org/headers
.. _/get: http://httpbin.org/get
.. _/: http://httpbin.org/
.. _/ip: http://httpbin.org/ip
.. _/gzip: http://httpbin.org/gzip
.. _/deflate: http://httpbin.org/deflate
.. _/status/:code: http://httpbin.org/status/418
.. _/response-headers: http://httpbin.org/response-headers?Content-Type=text/plain;%20charset=UTF-8&Server=httpbin
.. _/redirect/:n: http://httpbin.org/redirect/6
.. _/redirect-to?url=foo: http://httpbin.org/redirect-to?url=http://example.com/
.. _/redirect-to?url=foo&status_code=307:
http://httpbin.org/redirect-to?url=http://example.com/&status_code=307
.. _/relative-redirect/:n: http://httpbin.org/relative-redirect/6
.. _/cookies: http://httpbin.org/cookies
.. _/cookies/set?name=value: http://httpbin.org/cookies/set?k1=v1&k2=v2
.. _/cookies/delete?name: http://httpbin.org/cookies/delete?k1&k2
.. _/basic-auth/:user/:passwd: http://httpbin.org/basic-auth/user/passwd
.. _/hidden-basic-auth/:user/:passwd: http://httpbin.org/hidden-basic-auth/user/passwd
.. _/digest-auth/:qop/:user/:passwd: http://httpbin.org/digest-auth/auth/user/passwd
.. _/stream/:n: http://httpbin.org/stream/20
.. _/delay/:n: http://httpbin.org/delay/3
.. _/drip: http://httpbin.org/drip?numbytes=5&duration=5&code=200
.. _/range/:n: http://httpbin.org/range/1024
.. _/html: http://httpbin.org/html
.. _/robots.txt: http://httpbin.org/robots.txt
.. _/deny: http://httpbin.org/deny
.. _/cache: http://httpbin.org/cache
.. _/cache/:n: http://httpbin.org/cache/60
.. _/bytes/:n: http://httpbin.org/bytes/1024
.. _/stream-bytes/:n: http://httpbin.org/stream-bytes/1024
.. _/links/:n: http://httpbin.org/links/10
.. _/forms/post: http://httpbin.org/forms/post
.. _/xml: http://httpbin.org/xml
.. _/encoding/utf8: http://httpbin.org/encoding/utf8
DESCRIPTION
-----------
Testing an HTTP Library can become difficult sometimes.
`RequestBin <http://requestb.in>`__ is fantastic for testing POST
requests, but doesn't let you control the response. This exists to cover
all kinds of HTTP scenarios. Additional endpoints are being considered.
All endpoint responses are JSON-encoded.
EXAMPLES
--------
$ curl http://httpbin.org/ip
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
::
{"origin": "24.127.96.129"}
$ curl http://httpbin.org/user-agent
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
::
{"user-agent": "curl/7.19.7 (universal-apple-darwin10.0) libcurl/7.19.7 OpenSSL/0.9.8l zlib/1.2.3"}
$ curl http://httpbin.org/get
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
::
{
"args": {},
"headers": {
"Accept": "*/*",
"Connection": "close",
"Content-Length": "",
"Content-Type": "",
"Host": "httpbin.org",
"User-Agent": "curl/7.19.7 (universal-apple-darwin10.0) libcurl/7.19.7 OpenSSL/0.9.8l zlib/1.2.3"
},
"origin": "24.127.96.129",
"url": "http://httpbin.org/get"
}
$ curl -I http://httpbin.org/status/418
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
::
HTTP/1.1 418 I'M A TEAPOT
Server: nginx/0.7.67
Date: Mon, 13 Jun 2011 04:25:38 GMT
Connection: close
x-more-info: http://tools.ietf.org/html/rfc2324
Content-Length: 135
$ curl https://httpbin.org/get?show\_env=1
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
::
{
"headers": {
"Content-Length": "",
"Accept-Language": "en-US,en;q=0.8",
"Accept-Encoding": "gzip,deflate,sdch",
"X-Forwarded-Port": "443",
"X-Forwarded-For": "109.60.101.240",
"Host": "httpbin.org",
"Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
"User-Agent": "Mozilla/5.0 (X11; Linux i686) AppleWebKit/535.11 (KHTML, like Gecko) Chrome/17.0.963.83 Safari/535.11",
"X-Request-Start": "1350053933441",
"Accept-Charset": "ISO-8859-1,utf-8;q=0.7,*;q=0.3",
"Connection": "keep-alive",
"X-Forwarded-Proto": "https",
"Cookie": "_gauges_unique_day=1; _gauges_unique_month=1; _gauges_unique_year=1; _gauges_unique=1; _gauges_unique_hour=1",
"Content-Type": ""
},
"args": {
"show_env": "1"
},
"origin": "109.60.101.240",
"url": "http://httpbin.org/get?show_env=1"
}
Installing and running from PyPI
--------------------------------
You can install httpbin as a library from PyPI and run it as a WSGI app.
For example, using Gunicorn:
.. code:: bash
$ pip install httpbin
$ gunicorn httpbin:app
Or install and run it directly:
.. code:: bash
$ git clone https://github.com/Runscope/httpbin.git
$ pip install -e httpbin
$ python -m httpbin.core [--port=PORT] [--host=HOST]
Changelog
---------
- 0.5.0:
- Allow /redirect-to to work with multiple methods
- Allow MD5 or SHA-256 to be chosen as algorithms for HTTP Digest Auth
- Set a 10MB limit on /drip
- 0.4.1: Added floating-point support for /delay endpoint
- 0.4.0: New /image/svg endpoint, add deploy to heroku button, add 406 response to /image, and don't always emit the transfer-encoding header for stream endpoint.
- 0.3.0: A number of new features, including a /range endpoint, lots of
bugfixes, and a /encoding/utf8 endpoint
- 0.2.0: Added an XML endpoint. Also fixes several bugs with unicode,
CORS headers, digest auth, and more.
- 0.1.2: Fix a couple Python3 bugs with the random byte endpoints, fix
a bug when uploading files without a Content-Type header set.
- 0.1.1: Added templates as data in setup.py
- 0.1.0: Added python3 support and (re)publish on PyPI
AUTHOR
------
A `Runscope Community Project <https://www.runscope.com/community>`__.
Originally created by `Kenneth Reitz <http://kennethreitz.com/>`__.
SEE ALSO
--------
- https://www.hurl.it
- http://requestb.in
- http://python-requests.org
.. |Build Status| image:: https://travis-ci.org/Runscope/httpbin.svg
:target: https://travis-ci.org/Runscope/httpbin
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
|
