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.
• /put Returns PUT data.
• /delete Returns DELETE data
• /gzip Returns gzip-encoded data.
• /status/:code Returns given HTTP Status code.
• /response-headers?key=val eturns 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 a simple cookie.
• /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 lines.

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