HTTPBin

This is a Cloudflare Worker port of httpbin.org HTTP request & response testing service.

Available on https://httpbin.agrd.workers.dev/.

• Ideas for methods: https://httpbingo.org/.
• Code was mostly written by ChatGPT.

How to debug

Install dependencies and build:

npm install
npm run build

Run tests and lints:

npm run lint
npm run test

Run the local server:

npm run start

Development

This project is written in TypeScript and uses:

• TypeScript for type safety
• esbuild for fast bundling
• Cloudflare Workers runtime with type definitions

Endpoints

• / - This page.
• /absolute-redirect/:n - Absolute redirects n times.
• /anything/:anything - Returns anything that is passed to request.
• /base64/decode/:value - Decodes a Base64 encoded string.
• /base64/encode/:value - Encodes a string into Base64.
• /basic-auth/:user/:passwd - Challenges HTTPBasic Auth.
• /bytes/:n - Generates n random bytes of binary data, accepts optional seed integer parameter.
• /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.
• /cookies - Returns cookie data.
• /cookies/set?name=value - Sets one or more simple cookies.
• /cookies/delete?name - Deletes one or more simple cookies.
• /delay/:n - Delays responding for min(n, 10) seconds.
• /delete - Returns request data. Allows only DELETE requests.
• /forms/post - HTML form that submits to /post.
• /get - Returns request data. Allows only GET requests.
• /head - Returns request data. Allows only HEAD requests.
• /headers - Returns request header dict.
• /html - Renders an HTML Page.
• /hostname - Returns the name of the host serving the request.
• /image - Returns page containing an image based on sent Accept header.
• /image/jpeg - Returns a JPEG image.
• /image/png - Returns a PNG image.
• /image/svg - Returns a SVG image.
• /image/webp - Returns a WEBP image.
• /ip - Returns Origin IP.
• /json - Returns JSON.
• /json/:value - Returns the specified JSON.
• /links/:n - Returns page containing n HTML links.
• /patch - Returns request data. Allows only PATCH requests.
• /post - Returns request data. Allows only POST requests.
• /put - Returns request data. Allows only PUT requests.
• /range/:n - Streams n bytes, and allows specifying a Range header to select a subset of the data.
• /redirect-to?url=foo&status_code=307 - Redirects to the foo URL.
• /redirect-to?url=foo - 302 Redirects to the foo URL.
• /redirect/:n - 302 Redirects n times.
• /response-headers?key=val - Returns given response headers.
• /status/:code - Returns given HTTP Status code.
• /status-no-response/:code - Returns given HTTP Status code with empty body.
• /user-agent - Returns user-agent.
• /xml - Returns some XML.
• /xml/:value - Returns the specified XML.

Oblivious HTTP (OHTTP) Gateway Endpoints

Httpbin also includes Oblivious HTTP gateway endpoints as specified in RFC 9458.

• /ohttp/config - Returns the OHTTP KeyConfig that clients use to encapsulate their requests.
• /ohttp/gateway - Accepts OHTTP-encapsulated requests, decapsulates them, processes them internally against httpbin endpoints (regardless of the target host), and returns OHTTP-encapsulated responses.