simpleWebUtils API 文档

UA echo / UA 解析

GET /ua

回显请求的 User-Agent 头(纯文本)

GET /ua/analyze

结构化解析 User-Agent(浏览器、操作系统、设备等),返回 JSON

GET /ua/html

以 HTML 页面展示 User-Agent 解析结果

IP 地理查询

GET /ip

回显客户端 IP(纯文本)。经 CDN/反向代理访问时按 CF-Connecting-IP、True-Client-IP、X-Client-IP、X-Original-Forwarded-For、X-Forwarded-For、X-Real-IP 头识别真实来源

GET /ip/analyze

基于 GeoLite2-City 数据库查询客户端 IP 的地理位置(国家、城市、经纬度等),返回 JSON;客户端 IP 的 CDN/反代头识别与 /ip 相同

GET /ip/html

以 HTML 页面展示客户端 IP 及其地理位置查询结果;客户端 IP 的 CDN/反代头识别与 /ip 相同

Status code reference

GET /code/:code

以该状态码作为响应状态返回(空响应体),任意数字均可,用于测试客户端对状态码的处理

参数	位置	默认值	说明
`code`	path	—	HTTP 状态码,如 200、418;任意数字均可

code path

GET /code/detail/:code

返回该状态码的参考信息 JSON:描述、MDN 与 http.cat 链接;未收录的码返回 400

参数	位置	默认值	说明
`code`	path	—	HTTP 状态码,需在参考表内,如 404

code path

GET /code/html/:code

以 HTML 页面展示该状态码的描述(页面状态恒为 200,被测码只体现在页面内容里)

参数	位置	默认值	说明
`code`	path	—	HTTP 状态码,需在参考表内,如 404

code path

Minecraft MOTD 查询

GET /minecraft/bedrock/:server

查询 Bedrock 服务器 MOTD 与在线人数(RakNet unconnected ping,UDP);端口缺省 19132;目标地址经 SSRF 防护,拒绝 loopback/私网/链路本地/组播地址

参数	位置	默认值	说明
`server`	path	—	服务器地址(域名或 IP)

server path

GET /minecraft/bedrock/:server/:port

查询 Bedrock 服务器 MOTD 与在线人数(RakNet unconnected ping,UDP);端口缺省 19132;目标地址经 SSRF 防护,拒绝 loopback/私网/链路本地/组播地址

参数	位置	默认值	说明
`server`	path	—	服务器地址(域名或 IP)
`port`	path	`19132`	服务器端口

server path port path

POST /minecraft/bedrock

查询 Bedrock 服务器 MOTD 与在线人数(RakNet unconnected ping,UDP);端口缺省 19132;目标地址经 SSRF 防护,拒绝 loopback/私网/链路本地/组播地址;参数经 JSON body 传递

参数	位置	默认值	说明
`server`	body	—	服务器地址(域名或 IP),必填
`port`	body	`19132`	服务器端口

JSON body

GET /minecraft/java/:server

查询 Java 服务器 MOTD 与在线人数(Server List Ping,TCP);端口缺省 25565;目标地址经 SSRF 防护,拒绝 loopback/私网/链路本地/组播地址

参数	位置	默认值	说明
`server`	path	—	服务器地址(域名或 IP)

server path

GET /minecraft/java/:server/:port

查询 Java 服务器 MOTD 与在线人数(Server List Ping,TCP);端口缺省 25565;目标地址经 SSRF 防护,拒绝 loopback/私网/链路本地/组播地址

参数	位置	默认值	说明
`server`	path	—	服务器地址(域名或 IP)
`port`	path	`25565`	服务器端口

server path port path

POST /minecraft/java

查询 Java 服务器 MOTD 与在线人数(Server List Ping,TCP);端口缺省 25565;目标地址经 SSRF 防护,拒绝 loopback/私网/链路本地/组播地址;参数经 JSON body 传递

参数	位置	默认值	说明
`server`	body	—	服务器地址(域名或 IP),必填
`port`	body	`25565`	服务器端口

JSON body

MCP server

GET /mcp

服务索引:serverInfo(含版本)与支持的方法列表(initialize、tools/list、tools/call)

POST /mcp

JSON-RPC 2.0 端点:method 支持 initialize、tools/list、tools/call;tools/call 提供 bedrock_motd、java_motd 两个 tool(参数 server 必填,port 可选,默认 19132/25565);notification(无 id)返回 204

参数	位置	默认值	说明
`body`	body	—	JSON-RPC 2.0 请求体,如 {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"bedrock_motd","arguments":{"server":"example.com"}}}

JSON body

请求头回显

GET /headers

以 JSON 回显请求的全部头,同名多值以 ", " 连接

UUID 生成

GET /uuid

返回一个随机生成的 UUID v4(JSON),每次调用结果不同

Base64 编解码

GET /base64/:text

对路径中的文本做标准 base64 编码,返回 JSON

参数	位置	默认值	说明
`text`	path	—	待编码的文本

text path

GET /unbase64/:text

对路径中的 base64 字符串解码,非法输入返回 400

参数	位置	默认值	说明
`text`	path	—	待解码的 base64 字符串

text path

延迟响应

GET /delay/:seconds

等待指定秒数后返回 200 {"delay": seconds};秒数须为 1–10 的整数,非法或超限返回 400

参数	位置	默认值	说明
`seconds`	path	—	延迟秒数,整数 1–10

seconds path

请求回显

POST /echo

回显请求方法与原始请求体,返回 200 {"method": "POST", "body": <原样请求体>};空 body 为 ""

参数	位置	默认值	说明
`body`	body	—	原样回显的请求体

JSON body