Search
K
Rucho

Returns `n` random bytes as the response body.

Response headers: Content-Type: application/octet-stream, Content-Length: n.
n is capped at MAX_BYTES_RESPONSE_SIZE (10 MiB); larger values return 400.
n = 0 returns an empty 200 OK.

The body is filled via rand::thread_rng().fill_bytes(&mut buf[..]) for
maximum-entropy payloads (useful for verifying binary integrity through a
proxy, since any tampering is observable).

get
https://rucho.org/bytes/{n}

Path Parameters

nintegerrequired

Number of random bytes to return (max 10485760)

>= 0

Response

application/octet-stream

Returns n random bytes as application/octet-stream

string
get/bytes/{n}
 
application/octet-stream

`/cache` — conditional-request endpoint.

Returns 304 Not Modified if the request carries If-None-Match or
If-Modified-Since; otherwise 200 with ETag + Last-Modified headers
and a JSON echo, so a client can revalidate on the next request.

get
https://rucho.org/cache

Response

Cacheable JSON echo with ETag + Last-Modified

get/cache
 

`/cache/:n` — returns `200` with `Cache-Control: public, max-age=n`.

get
https://rucho.org/cache/{n}

Path Parameters

ninteger(int64)required

>= 0

Response

200

JSON echo with Cache-Control: public, max-age=n

get/cache/{n}
 
200

Returns all cookies from the request as JSON.

Parses the Cookie header and returns a JSON object with a cookies key
containing a map of cookie name-value pairs.

Example Response

{ "cookies": { "session": "abc123", "theme": "dark" } }
get
https://rucho.org/cookies

Response

200 application/json

Returns all cookies from the request

get/cookies
 
200 application/json

Deletes cookies via the `DELETE` method on `/cookies` — RESTful symmetry with

GET /cookies/delete. Each query-parameter name expires the matching cookie
(Max-Age=0), and the response is a 302 redirect to /cookies.

Example

DELETE /cookies?foo&theme expires both cookies and redirects.

delete
https://rucho.org/cookies

Query Parameters

objectrequired

Cookie names to delete

Response

302

Redirects to /cookies after deleting cookies

delete/cookies
 
302