Rucho

`/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

Deletes cookies by setting `Max-Age=0` and redirects to `/cookies`.

Each query parameter name is used to expire the corresponding cookie.
The value of the query parameter is ignored.

Example

GET /cookies/delete?foo&theme expires both cookies and redirects.

get
https://rucho.org/cookies/delete

Query Parameters

objectrequired

Cookie names to delete

Response

302

Redirects to /cookies after deleting cookies

get/cookies/delete
 
302