请求回显与测试数据 API

回显 HTTP 请求（方法、头、参数、IP），生成明显虚构的测试数据

数据来源：本地计算

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

请求回显：返回服务器收到的方法、路径、查询参数、请求头、请求体和客户端 IP（Cookie、Authorization、API Key 等凭据会被去掉）

GET /api/tools/echo

请求参数

  • message：示例参数；实际可以附带任意参数，都会原样回显（名称像凭据的参数除外），示例 hello

返回字段

  • method（string）：请求方法：GET 或 POST
  • path（string）：请求路径（不含查询参数）
  • query（object）：网址中的查询参数，键名不固定
  • query.*（string|array）：一个查询参数的值；同名参数出现多次时为字符串数组
  • query.*[]（string）：同名参数的其中一个值
  • body（string|null）：POST 时为请求体 JSON 解析后再序列化的字符串（紧凑格式）；GET 或没有请求体时为 null
  • headers（object）：服务器收到的请求头（名称为小写），键名不固定；部署在反向代理后面时会多出 x-forwarded-for 等代理添加的头
  • headers.*（string）：一个请求头的值；同名头出现多次时用 “, ” 连接
  • removedHeaders（array）：出于安全考虑没有回显的请求头名称（如 cookie、authorization、x-api-key，以及名称含 token、secret、session、auth 等字样的头），可能为空数组
  • removedHeaders[]（string）：被去掉的请求头名称（小写）
  • removedQuery（array）：没有回显的查询参数名称（本站的 API Key 参数 key，以及名称含 token、secret、password 等字样的参数），可能为空数组
  • removedQuery[]（string）：被去掉的查询参数名称
  • ip（string|null）：服务器识别到的客户端 IP（开启 TRUST_PROXY 时取 X-Forwarded-For 的第一个地址）
  • httpVersion（string|null）：HTTP 协议版本，如 1.1；取不到时为 null
  • time（string）：服务器处理请求的时间，ISO 8601 UTC

请求回显：返回服务器收到的方法、路径、查询参数、请求头、请求体和客户端 IP（Cookie、Authorization、API Key 等凭据会被去掉）

POST /api/tools/echo

请求参数

  • message：示例参数；实际可以附带任意参数，都会原样回显（名称像凭据的参数除外），示例 hello

返回字段

  • method（string）：请求方法：GET 或 POST
  • path（string）：请求路径（不含查询参数）
  • query（object）：网址中的查询参数，键名不固定
  • query.*（string|array）：一个查询参数的值；同名参数出现多次时为字符串数组
  • query.*[]（string）：同名参数的其中一个值
  • body（string|null）：POST 时为请求体 JSON 解析后再序列化的字符串（紧凑格式）；GET 或没有请求体时为 null
  • headers（object）：服务器收到的请求头（名称为小写），键名不固定；部署在反向代理后面时会多出 x-forwarded-for 等代理添加的头
  • headers.*（string）：一个请求头的值；同名头出现多次时用 “, ” 连接
  • removedHeaders（array）：出于安全考虑没有回显的请求头名称（如 cookie、authorization、x-api-key，以及名称含 token、secret、session、auth 等字样的头），可能为空数组
  • removedHeaders[]（string）：被去掉的请求头名称（小写）
  • removedQuery（array）：没有回显的查询参数名称（本站的 API Key 参数 key，以及名称含 token、secret、password 等字样的参数），可能为空数组
  • removedQuery[]（string）：被去掉的查询参数名称
  • ip（string|null）：服务器识别到的客户端 IP（开启 TRUST_PROXY 时取 X-Forwarded-For 的第一个地址）
  • httpVersion（string|null）：HTTP 协议版本，如 1.1；取不到时为 null
  • time（string）：服务器处理请求的时间，ISO 8601 UTC

生成随机测试数据：姓名、手机号、邮箱、地址、公司、IP、MAC、UUID 等，全部明显虚构（不生成身份证号）

GET /api/tools/mock

请求参数

  • type：user 完整用户（对象）；name 姓名；phone 手机号（100 开头，非真实号段）；email 邮箱（example.com 等保留域名）；address 地址（示例路 / 测试街）；company 公司；ip IPv4（RFC 5737 文档网段）；ipv6 IPv6（2001:db8::/32）；mac MAC 地址（本地管理地址）；uuid；date 日期；color 颜色，示例 name
  • count：数量（1~50），示例 3

返回字段

  • type（string）：数据类型，与请求参数 type 相同
  • items（array）：生成结果，长度等于 count；type=user 时每项是对象，其他类型每项是字符串
  • items[]（string|object）：一条随机数据
  • items[].name（string）：姓名（随机姓氏 + 1~2 个与性别相符的常见字）
  • items[].gender（string）：性别：男 / 女
  • items[].age（number）：年龄（18~65）
  • items[].phone（string）：手机号：100 开头的 11 位数字，不是任何运营商的号段
  • items[].email（string）：邮箱，域名为 RFC 2606 保留的 example.com / example.org / example.net
  • items[].address（string）：地址：真实的省市区 + 虚构的“示例路 / 测试街”等路名和门牌
  • items[].company（string）：公司名，统一带“示例有限公司”字样