README.md

httpbin(1): HTTP Request & Response Service

Freely hosted in HTTP & HTTPS flavors.

ENDPOINTS

• / 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.
• /status/:code Returns given HTTP Status code.
• /response-headers?key=val Returns given response headers.
• /redirect/:n 302 Redirects n times.
• /relative-redirect/:n 302 Relative redirects n times.
• /cookies Returns cookie data.
• /cookies/set?name=value Sets 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.
• /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 header is provided, when it returns a 304.

DESCRIPTION

Testing an HTTP Library can become difficult sometimes. PostBin.org is fantastic for testing POST requests, but not much else. This exists to cover all kinds of HTTP scenarios. Additional endpoints are being considered (e.g. /deflate).

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

AUTHOR

A Kenneth Reitz Project.

SEE ALSO

http://python-requests.org