gzip-encoded JSON echo of the request
Returns a gzip-encoded JSON echo of the request (`Content-Encoding: gzip`).
get
https://rucho.org/gzip
Response
200
Response
200
get/gzip
200
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
Response
application/octet-stream
Returns n random bytes as application/octet-stream
string
get/bytes/{n}
Path Parameters
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
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
Response
200
JSON echo with Cache-Control: public, max-age=n
get/cache/{n}
Path Parameters
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
Response
200 application/json
Returns all cookies from the request
get/cookies
200 application/json