HTTP me!

HTTP me is an app initally designed to replicate the features of HTTPBin.org: being a convenient server that you can use to trigger a certain HTTP response behaviour.

It was previously a JavaScript project on Glitch, but has since been migrated to a Rust application running on Fastly Compute.

Usage

Request any path you like, as long as it is not / (which produces this page). Most directives can be duplicated or combined, and can be specified in multiple ways. If directives are mutually exclusive, those specified later take priority, and path segments take priority over query args, which take priority over headers.

Path segments

Any directive can be specified as a path segment. This returns the current time:

/now

Or this returns a 500 status code:

/status=500

Query string

Directives can also be part of the query string. Stackable directives (see below) can be specified multiple times, such as header:

/now?wait=1000&header=Cache-Control:max-age=300&header=Content-Type:text/plain

Headers

Add directives as request headers, prefixed with HM-:

HM-Wait: 2000
HM-Status: 500

Directives

The following stackable directives are available:

• wait=<number>: Sleep for <number> milliseconds before starting the response. Capped at 30 seconds.
• status=<number>: Set <number> as the HTTP Response status code
• header=<key>:<val>: Set the response's header for <key> to <val>, replacing any previously-specified value
• append-header=<key>:<val>: Add a response header of <key>: <val> to the response, allowing multiple headers with the same key
• cacheable: Make the response cacheable for a short period (shorthand for header=Cache-Control:max-age=300)
• cache=<number>: Make the response cacheable for a custom period (shorthand for header=Cache-Control:max-age=<number>)
• no-cache: Make the response uncacheable (shorthand for header=Cache-Control:no-store,private)
• redirect=<url>: Redirect to the specified URL with a 308 status code (shorthand for status=308 and header=Location:<url>)

The following content directives are mutually exclusive. Only one will be honoured.

• debug: Output a JSON object describing the directives parsed from the request
• now / time: Output the current time
• ip: Output the IP address of the requesting client
• html: Output a valid HTML page
• json: Output a valid JSON document
• image-jpeg: Output a JPEG image
• image-png: Output a PNG image
• image-webp: Output a WEBP image
• image-gif: Output an animated GIF image
• image-svg: Output an SVG image
• stream-sse=<duration>: Output a Server Sent Events stream for <duration> milliseconds. Capped at 30 seconds.
• drip=<duration>: Output a plain stream that sends a character every <duration> milliseconds. Capped at 30 seconds.
• body=<string>: Echo the input data
• base64=<data>: Echo the input data but base64-decode it first
• esi: Returns an HTML containing an ESI request to /time, which returns the local server date and time.
• gzip: Returns a gzipped JSON response
• anything: Returns a JSON response describing the request