---

NOTE: This is a forked version of httpbin from Runscope.

Freely hosted in HTTP, HTTPS, HTTP/2 & EU flavors by Runscope

ENDPOINTS

DESCRIPTION

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.5.0

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"
}

$ curl -XPOST https://httpbin.org/file/dir1/dir2?name=myfile.json

{
  "file_path": "/tmp/dir1/dir2/myfile.json"
}

$ curl https://httpbin.org/file/dir1/dir2?name=myfile.json

{
  "content1": "foo bar",
  "content2": "fizz buzz"
}

$ curl https://httpbin.org/file/dir1/dir2

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--

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:

$ pip install httpbin
$ gunicorn httpbin:app

Or install and run it directly:

$ git clone https://github.com/Runscope/httpbin.git
$ pip install -e httpbin
$ python -m httpbin.core [--port=PORT] [--host=HOST] [--enable-file-endpoint] [--disable-file-endpoint]

Changelog

• 0.6.0:

• Added /file endpoint to create, get or delete a file

• 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 Kenneth Reitz Project.

SEE ALSO

• https://www.hurl.it
• http://requestb.in
• http://python-requests.org