---
title: "rucho"
description: "A blazing fast HTTP echo server and request inspector. Point a gateway at it, send anything, see exactly what arrived."
url: "https://developer.rucho.org/"
image: "https://developer.rucho.org/_og/d/c_Ocean.takumi,title_rucho,description_~QSBibGF6aW5nIGZhc3QgSFRUUCBlY2hvIHNlcnZlciBhbmQgcmVxdWVzdCBpbnNwZWN0b3IuIFBvaW50IGEgZ2F0ZXdheSBhdCBpdCwgc2VuZCBhbnl0aGluZywgc2VlIGV4YWN0bHkgd2hhdCBhcnJpdmVkLg,props_eyJ0aGVtZSI6eyJtb2RlIjoiZGFyayIsImNvbG9ycyI6eyJwcmltYXJ5IjoiI0U4NTQxRiJ9fX0,s_06GMQQipAVPgGsO_.png"
---

# rucho

A fast, reliable HTTP echo server and request inspector. Point a gateway at it, send anything, and see exactly what arrived — headers, body, client IP, negotiated TLS, timing.

[API Reference](https://developer.rucho.org/apis)

## [Try it right now](#try-it-right-now)

No signup, no key, no application to register. It answers immediately:

```bash
curl https://rucho.org/get
```

Ask it for a specific status, a slow response, or a redirect chain — whatever stimulus you need the gateway to react to:

```bash
curl https://rucho.org/status/503        # any status code you name
curl https://rucho.org/delay/3           # 3s before the first byte
curl https://rucho.org/redirect/5        # a 5-hop 302 chain
curl "https://rucho.org/response-headers?x-trace=abc"   # headers you choose
```

Everything lives behind Kong on `rucho.org`, and the same image runs locally:

```bash
docker run -p 8080:8080 rumpus/rucho:1.6.0
```

---

## What's in here

Thirty-seven endpoints, grouped by the thing you're trying to test.

### [Request Inspection](#request-inspection)

Echo the request back: method, headers, body, client IP, negotiated TLS.

### [Response Control](#response-control)

Make the upstream emit a specific status, header set, redirect chain, or latency.

### [Content Types](#content-types)

Non-JSON bodies — XML, HTML, images, decoded base64, byte ranges.

### [Compression](#compression)

Already-encoded bodies (gzip/deflate/brotli) regardless of `Accept-Encoding`.

### [Caching & Streaming](#caching-streaming)

Revalidation, cache directives, and chunked drip-feed responses.

### [Cookies](#cookies)

Inspect, set, and expire cookies.

### [Service](#service)

Health, metrics, and the runtime endpoint list.

### [Utility](#utility)

Generators: random bytes and UUIDs.

---

## Full reference

Every endpoint, with parameters and response shapes. The console sends real requests.

![Rucho](https://developer.rucho.org/_core/api/v3/apis/rucho/images/icon/raw)

## Rucho

1.6.0

Echo server and HTTP request inspector for testing gateway behavior. 37 endpoints covering request echo, status codes, delays, redirects, cookies, content types, compression, and caching.

[Open reference](https://developer.rucho.org/apis/rucho/docs)