mirror of
https://github.com/kennethreitz/httpbin.git
synced 2026-06-05 23:00:18 +00:00
Dave Challis
414a719b42
'/bytes/:n' takes and optional 'seed' integer parameter, and returns n random bytes of binary data (limited to 100KB in size). '/stream-bytes/:n' is the same as above, but streams the data. As well as a 'seed' parameter, it accepts a 'chunk_size' parameter, which determines how many bytes are in each packet that is streamed. '/links/:n' generates a page containing n links, each of which links to another page containing those n links. The value of n is limited to 200.
httpbin(1): HTTP Request & Response Service
Freely hosted in HTTP & HTTPS flavors.
ENDPOINTS
/This page./ipReturns Origin IP./user-agentReturns user-agent./headersReturns header dict./getReturns GET data./postReturns POST data./patchReturns PATCH data./putReturns PUT data./deleteReturns DELETE data/gzipReturns gzip-encoded data./status/:codeReturns given HTTP Status code./response-headers?key=valReturns given response headers./redirect/:n302 Redirects n times./redirect-to?url=foo302 Redirects to the foo URL./relative-redirect/:n302 Relative redirects n times./cookiesReturns cookie data./cookies/set?name=valueSets one or more simple cookies./basic-auth/:user/:passwdChallenges HTTPBasic Auth./hidden-basic-auth/:user/:passwd404'd BasicAuth./digest-auth/:qop/:user/:passwdChallenges HTTP Digest Auth./stream/:nStreams n–100 lines./delay/:nDelays responding for n–10 seconds./htmlRenders an HTML Page./robots.txtReturns some robots.txt rules./denyDenied by robots.txt file./cacheReturns 200 unless an If-Modified-Since or If-None-Match header is provided, when it returns a 304./bytes/:nGenerates n random bytes of binary data, accepts optional seed integer parameter./stream-bytes/:nStreams n random bytes of binary data, accepts optional seed and chunk_size integer parameters./links/:nReturns page containing n HTML links.
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.