edgebin

🚀 edgebin

轻量、高效的边缘 HTTP 测试与调试服务

基于 Cloudflare Workers 构建,兼容绝大多数 httpbin.org 接口规范,毫秒级响应。

🌐 服务地址:https://ip.zoogooo.com · 问题反馈

Cloudflare Workers License


📌 端点速查表

💡 提示:除了专属 HTTP 动词端点(如 /get、/post),其余测试端点均允许任意 HTTP 方法请求。

方法 端点 说明
GET /get 回显 GET 请求参数、标头与来源信息
POST /post 回显 POST 提交的 Body(JSON/表单/文本)及标头
PUT /put 回显 PUT 提交的数据及标头
DELETE /delete 回显 DELETE 操作请求
ANY /anything 回显任意请求方法、载荷及全部元数据
ANY /anything/:anything 支持多级嵌套路径,回显请求数据
GET /ip 获取请求方公网 IP 地址
GET /ipgeo 获取客户端 IP、国家、城市、ASN 及坐标
GET /reverse-geo 根据经纬度反查中国境内省、市、县/区
GET /user-agent 获取客户端 User-Agent 字符串
GET /headers 获取客户端发送的所有 HTTP 请求头
ANY /status/:code 返回指定的 HTTP 状态码(如 418, 500)
ANY /response-headers 响应中返回指定的自定义标头
ANY /redirect/:n 连续 302 重定向 n 次
ANY /delay/:n 延迟 n 秒后响应返回
GET /basic-auth/:user/:passwd HTTP Basic Auth 挑战认证
GET /bearer HTTP Bearer Token 验证
GET /cookies 获取请求携带的所有 Cookie
GET /cookies/set?k=v 设置 Cookie 并重定向到 /cookies
GET /cookies/delete?k=v 删除指定 Cookie 并重定向
GET /cache/:max-age 返回带有指定 Cache-Control 缓存头的响应
GET /json 返回示例 JSON 文档
GET /xml 返回示例 XML 文档
GET /html 返回示例 HTML 网页
GET /csv/:name/:limit 返回示例 CSV 数据集(customers 等)
GET /bytes/:n 返回 n 个随机二进制字节
GET /gzip 返回 Gzip 压缩编码响应
GET /brotli 返回 Brotli (br) 压缩编码响应
GET /deflate 返回 Deflate 压缩编码响应
GET /image/:type 返回指定格式图片(png, jpeg, webp, svg)
GET /image/:w/:h 生成指定尺寸与配色的 SVG 占位图
ANY /qrcode 快速生成 SVG 矢量二维码
ANY /md2html / /html2md Markdown 与 HTML 双向转换
GET /page-meta 抓取网页并提取 Open Graph 与标题元数据
GET /date 获取格式化当前时间与时区
ANY /mix 组合指令模拟状态码、延迟与响应标头
WS /ws WebSocket 连接实时 Echo 回显消息

✨ 功能详解与示例

1. HTTP 动词端点 (GET POST PUT DELETE)

用于调试各种 HTTP 方法的请求载荷、Query 参数及请求头。

# POST 提交 JSON 数据
curl -X POST "https://ip.zoogooo.com/post"   -H "Content-Type: application/json"   -d '{"name": "edgebin", "active": true}'

# POST 提交表单数据
curl -X POST "https://ip.zoogooo.com/post"   -d "user=alice&token=xyz123"

响应回显包含解析后的 json、form、data 以及客户端请求标头。


2. IP、地理位置与县区反查 (GET)

访问 /ip 或 /ipgeo 获取客户端 IP、经纬度、国家、城市与 ASN。当请求源自中国境内时,自动匹配县级行政区划:

curl https://ip.zoogooo.com/ip
{
  "origin": "203.0.113.1",
  "continent": "AS",
  "country": "CN",
  "region": "Zhejiang",
  "regionCode": "ZJ",
  "city": "Hangzhou",
  "postalCode": "310000",
  "latitude": "30.29365",
  "longitude": "120.16142",
  "timezone": "Asia/Shanghai",
  "asn": 4837,
  "asOrganization": "China Unicom",
  "colo": "LAX",
  "district": {
    "code": "330105",
    "province": "浙江省",
    "city": "杭州市",
    "district": "拱墅区"
  }
}

独立经纬度反查接口 (/reverse-geo)

根据经纬度反查中国境内所在省、市、县/区(基于全国 2890+ 县级矢量边界射线法判定,别名 /geocode):

curl "https://ip.zoogooo.com/reverse-geo?lat=30.29365&lng=120.16142"
{
  "code": "330105",
  "province": "浙江省",
  "city": "杭州市",
  "district": "拱墅区",
  "name": "拱墅区",
  "latitude": 30.29365,
  "longitude": 120.16142
}

3. WebSocket 实时回显 (WS)

连接 /ws 实时回显发送的消息,可用于快速检验边缘节点的 WebSocket 连通性:

wscat -c wss://ip.zoogooo.com/ws

4. 矢量二维码生成 (ANY)

访问 /qrcode 实时生成 SVG 格式二维码。

curl "https://ip.zoogooo.com/qrcode?text=https://ip.zoogooo.com&width=200"

5. Markdown 与 HTML 双向转换 (ANY)

支持通过请求体、URL 参数或远程网址进行格式互转:

# Markdown 转 HTML
curl "https://ip.zoogooo.com/md2html" --data "# Hello, World"

# HTML 转 Markdown
curl "https://ip.zoogooo.com/html2md" --data "<h1>Hello, World</h1>"

# 抓取并转换远程网页
curl "https://ip.zoogooo.com/md2html?url=https://example.com"

6. 网页元数据提取 (GET)

抓取指定网页并解析 Open Graph、页面标题及描述:

curl "https://ip.zoogooo.com/page-meta?url=https://ip.zoogooo.com"

7. 当前时间与时区 (GET)

curl "https://ip.zoogooo.com/date?format=iso"
curl "https://ip.zoogooo.com/date?format=locale&locale=zh-CN&timeZone=Asia/Shanghai"

8. SVG 动态占位图服务 (GET)

方便前端快速生成布局占位图,无需加载外部繁重图片资源:

# 默认 640x480
curl "https://ip.zoogooo.com/image/640/480"

# 自定义尺寸、背景色、文字颜色与内容
curl "https://ip.zoogooo.com/image/300?background=2563EB&foreground=FFFFFF&text=Demo"

9. 自定义模拟响应 (ANY /mix)

自由构造各种边界测试条件:

curl "https://ip.zoogooo.com/mix?s=418&d=2&h=X-Test:ok" -d "Custom Body"

10. 示例数据集与格式检验 (GET)


💻 本地开发与部署

基于 Cloudflare Workers 构建,使用 Wrangler 工具链:

# 安装依赖
npm install

# 启动本地开发服务 (http://localhost:8787)
npm run dev

# 编译文档静态页面
npm run build

# 部署至 Cloudflare Workers
npm run deploy

📄 开源许可

本项目基于 MIT License 开源。