httpbin-hono

A httpbin implementation built with Hono and deployed on Cloudflare Workers.

🌐 Live Demo: httpbin-hono.naas.workers.dev

httpbin is a simple HTTP Request & Response service, useful for testing HTTP clients and APIs. Special thanks to Kenneth Reitz for creating the original httpbin project. This implementation is inspired by and built upon the foundation of httpbin.

• Original httpbin: httpbin.org
• httpbin GitHub: github.com/postmanlabs/httpbin
• Kenneth Reitz: kennethreitz.org

🚀 Deploy in One Click

Self-host your own httpbin instance on Cloudflare Workers in seconds. No configuration needed—just click the button below and deploy directly to your Cloudflare account. Get your own private httpbin service with no rate limits, complete control, and full customization.

After deployment, your httpbin service will be available at https://your-worker-name.your-subdomain.workers.dev. Visit the root endpoint to access the interactive Swagger UI documentation.

Why httpbin-hono?

• 🚀 Easy Cloudflare Deployment: Deploy to Cloudflare Workers with a single click—no Docker, no server management, no infrastructure setup required
• ⚡ Fast & Low Latency: Built on Cloudflare's global edge network for minimal latency worldwide
• 💰 Cost-Effective: Extremely affordable—free for most use cases thanks to Cloudflare Workers' generous free tier
• 🔧 Portable: Built with Hono, making it easy to deploy to other platforms (Node.js, Deno, Bun, etc.) if needed

Prerequisites

• Bun (v1.3 or later)

Installation

bun install

Development

Start the development server:

bun run dev

The service will be available at http://localhost:8787 (or the port specified by Wrangler).

Deployment

Deploy Manually

Deploy to Cloudflare Workers:

bun run deploy

Type Generation

For generating/synchronizing types based on your Worker configuration, run:

bun run cf-typegen

Pass the Env as generics when instantiating Hono:

// src/index.ts
const app = new Hono<{ Bindings: Env }>()

Code Quality

Check code quality with Biome:

bun run check

Auto-fix issues:

bun run check:fix

API Documentation

Once the server is running, visit the root endpoint (/) to access the Swagger UI documentation, which provides an interactive interface to explore all available endpoints.

License

ISC. See the LICENSE file for details. The original httpbin project is © Kenneth Reitz and distributed under the ISC License.