Rucho

Returns all request headers as a JSON object.

Useful for debugging what headers are being sent by the client,
including auth tokens, proxy headers, and custom headers.

HTTP Method:

  • GET

Responses:

  • 200 OK: Returns a JSON object containing all request headers.
get
https://rucho.org/headers

Response

200 application/json

Returns all request headers

get/headers
 
200 application/json

Returns the client's IP address.

Extracts the client IP from request headers. Checks X-Forwarded-For first
(for proxied requests), then X-Real-IP as a fallback.

HTTP Method:

  • GET

Responses:

  • 200 OK: Returns a JSON object containing the client’s origin IP.
get
https://rucho.org/ip

Response

200 application/json

Returns the client’s IP address

get/ip
 
200 application/json

Handles OPTIONS requests to `/options`.

Responds with the allowed HTTP methods for this server in the Allow header.
The body of the response is empty.

HTTP Method:

  • OPTIONS

Responses:

  • 204 No Content: Returns an empty body with the Allow header set to
    “GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD”.
options
https://rucho.org/options

Response

204

No content, Allow header lists allowed methods

options/options
 
204

Handles PATCH requests to `/patch`.

Echoes back the request’s method, headers, and the parsed JSON body.
Expects a JSON request body.

HTTP Method:

  • PATCH

Request Body:

  • Payload: A generic JSON object.

Responses:

  • 200 OK: Returns a JSON object containing method, headers, and parsed body.
  • 400 Bad Request: If the request body is not valid JSON.
patch
https://rucho.org/patch

Body

application/json

Payload

Payload

Request payload wrapper for POST, PUT, PATCH, and DELETE handlers.

This newtype wraps a serde_json::Value to accept arbitrary JSON bodies
in requests that support request bodies.

Response

application/json

Echoes request details

patch/patch

Body

{}
 
application/json

Handles POST requests to `/post`.

Echoes back the request’s method, headers, and the parsed JSON body.
Expects a JSON request body.

HTTP Method:

  • POST

Request Body:

  • Payload: A generic JSON object.

Responses:

  • 200 OK: Returns a JSON object containing method, headers, and parsed body.
  • 400 Bad Request: If the request body is not valid JSON.
post
https://rucho.org/post

Body

application/json

Payload

Payload

Request payload wrapper for POST, PUT, PATCH, and DELETE handlers.

This newtype wraps a serde_json::Value to accept arbitrary JSON bodies
in requests that support request bodies.

Response

application/json

Echoes request details

post/post

Body

{}
 
application/json