Rucho

Responds with the HTTP status code specified in the path.

This handler allows testing of how a client handles different HTTP status codes.
It accepts any HTTP method.

Path Parameters:

  • code: The HTTP status code to return (e.g., 200, 404, 500).

Responses:

  • Returns the status code specified by the code path parameter.
  • If an invalid code is provided (e.g., not a number or out of valid range),
    it defaults to 400 Bad Request.
head
https://rucho.org/status/{code}

Path Parameters

codeinteger(int32)required

>= 0

Response

Returns the specified status code

head/status/{code}
 

Returns the User-Agent header from the request.

Extracts and returns the User-Agent header value. Useful for testing
what user agent string your client is sending.

HTTP Method:

  • GET

Responses:

  • 200 OK: Returns a JSON object containing the User-Agent string.
get
https://rucho.org/user-agent

Response

200 application/json

Returns the User-Agent header

get/user-agent
 
200 application/json

Returns a randomly generated UUID v4.

Generates a new random UUID (Universally Unique Identifier) using the v4 algorithm.
Useful for generating unique identifiers for testing purposes.

HTTP Method:

  • GET

Responses:

  • 200 OK: Returns a JSON object containing the generated UUID.
get
https://rucho.org/uuid

Response

200 application/json

Returns a randomly generated UUID

get/uuid
 
200 application/json

Handles requests to the `/base64/:encoded` endpoint.

Decodes the URL-path base64 string and returns a JSON payload with the
decoded content, a UTF-8 validity flag, and the decoded byte length.

Security

Input is capped at MAX_BASE64_INPUT_BYTES (4096 bytes) to prevent
denial-of-service attacks from oversized decode operations.

Path Parameters

  • encoded: The base64-encoded string to decode. URL-safe alphabet is
    preferred; padding is optional.

Responses

  • 200 OK: JSON object with encoded, decoded, is_utf8, byte_length,
    and timing.duration_ms.
  • 400 Bad Request: Invalid base64 input or input exceeds the size limit.
get
https://rucho.org/base64/{encoded}

Path Parameters

encodedstringrequired

URL-safe base64-encoded string to decode (max 4096 bytes)

Response

application/json

Returns decoded content with metadata

get/base64/{encoded}
 
application/json

Returns a brotli-encoded JSON echo (`Content-Encoding: br`).

get
https://rucho.org/brotli

Response

200

brotli-encoded JSON echo of the request

get/brotli
 
200