NOTE: This is a forked version of httpbin from Runscope.
Freely hosted in HTTP, HTTPS & EU flavors by Runscope
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. |
/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 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. |
/file/:path?name=filename | Creates a new file with name in path directory. Creates intermediate directories if necessary. If name is not provided, a unique name is assigned. |
/file/:path | Returns the content of all files in path directory as a multipart/form-data response |
Testing an HTTP Library can become difficult sometimes. RequestBin 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.
This is a forked version of httpbin with some additional functionality. It forks off version 0.4.1
$ curl http://httpbin.org/ip
{"origin": "24.127.96.129"}
{"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
{ "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" }
$ curl -XPOST https://httpbin.org/file/dir1/dir2?name=myfile.json
{ "file_path": "/tmp/dir1/dir2/myfile.json" }
{ "content1": "foo bar", "content2": "fizz buzz" }
GET /file/event/180 HTTP/1.1 Host: 127.0.0.1:5000 User-Agent: curl/7.43.0 Accept: */* HTTP 1.0, assume close after body HTTP/1.0 200 OK Content-Length: 1110 Content-Type: multipart/form-data; boundary=p5jzGj614zq3BEJaCXCZs8avaXHLEZ Access-Control-Allow-Origin: * Access-Control-Allow-Credentials: true Server: Werkzeug/0.9.4 Python/2.7.10 Date: Wed, 06 Apr 2016 06:10:13 GMT --p5jzGj614zq3BEJaCXCZs8avaXHLEZ Content-Disposition: form-data; name="ce0ceadd-1fd7-4b75-9ad7-063188065651"; filename="ce0ceadd-1fd7-4b75-9ad7-063188065651.json" Content-Type: application/json {"file1content1":"foo bar","file1content2":"fizz buzz"} --p5jzGj614zq3BEJaCXCZs8avaXHLEZ Content-Disposition: form-data; name="d4b39517-69d3-4074-8010-74dcfa1b8606"; filename="d4b39517-69d3-4074-8010-74dcfa1b8606.json" Content-Type: application/json {"file2content1":"foo bar","file2content2":"fizz buzz"} --p5jzGj614zq3BEJaCXCZs8avaXHLEZ Content-Disposition: form-data; name="event1"; filename="event1.txt" Content-Type: plain/text foo bar fizz buzz --p5jzGj614zq3BEJaCXCZs8avaXHLEZ--
You can install httpbin as a library from PyPI and run it as a WSGI app. For example, using Gunicorn:
$ pip install httpbin
$ gunicorn httpbin:app
Or run it directly:
$ python -m httpbin.core [--port=PORT] [--host=HOST] [--enable-file-endpoint] [--disable-file-endpoint]
- 0.5.2: Change ctime comparison in get_all_files_in_dir to >=
- 0.5.1: use request.get_data() to get POST request data
- 0.5.0: Added /file endpoint to create, get or delete a file
- 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
A Runscope Community Project. Originally created by Kenneth Reitz.