状态 Banner
实时生成 800×200 的服务器状态横幅图(PNG)。
GET /api/v1/server/banner
实时 ping 服务器并用 Satori 渲染为 800×200 PNG 横幅,内容包含 favicon、MOTD(带格式色)、 在线人数、版本与延迟。服务器离线时也会出图,显示「服务器离线」。
结果会写入 Redis 缓存(mcsearch:server:banner:<host>:<port>,TTL 60s),命中时 X-Cache: HIT。
直接嵌入
可以把接口地址直接作为图片地址使用:
<img
src="https://search.tecostudio.cn/api/v1/server/banner?host=mc.hypixel.net"
width="800"
height="200"
alt="server banner"
/>
参数
与公共参数一致:host(必填)、port、edition。