API 接口列表

接口一览

参数说明

创建赞助订单 /api/donate/create

赞助订单状态 /api/donate/order

赞助信息 /api/donate_info

服务器信息 /api/server_info

在线人数历史 /api/server_player_history

服务器状态（页面轮询用） /api/server_status

服务器状态图（图片） /api/server_status_image

服务器状态图（图片） /api/server_status_image/<int:server_id>

图床文件列表 /api/tuchuang

赞助记录管理 /api/admin/donations

服务器节点管理 /api/admin/servers

更新日志管理 /api/admin/updates

图床删除 /api/tuchuang/delete

图床重命名 /api/tuchuang/rename

图床上传 /api/tuchuang/upload

图床 API（上传 / 列表 / 改名 / 删除）

图床不再放在首页入口，改为纯 API 调用：可以上传图片和视频，拿到直链、Markdown、BBCode、 HTML 几种现成写法，直接发群或嵌进论坛帖子。

图片格式：avif、bmp、gif、ico、jpeg、jpg、png、svg、webp；视频格式：avi、m4v、mkv、mov、mp4、ogv、webm。 单张图片最大 8.0 MB，单个视频最大 64.0 MB。

# 1. 列出图床文件（返回直链 / Markdown / BBCode / HTML）
curl "https://locraft.cn/api/tuchuang?limit=20"
curl "https://locraft.cn/api/tuchuang?kind=image&folder=avatar"
curl "https://locraft.cn/api/tuchuang?format=list"   # 纯文本直链，每行一个

# 2. 上传（需要登录会话；配置 TUCHUANG_UPLOAD_TOKEN 后也可用 token 免登录）
curl -X POST "https://locraft.cn/api/tuchuang/upload" \
  -F "file=@screenshot.png" -F "folder=" -F "name="

# 3. 改名 / 删除（管理员）
curl -X POST "https://locraft.cn/api/tuchuang/rename" \
  -H "Content-Type: application/json" \
  -d "{\"file\": \"a.png\", \"name\": \"b.png\"}"
curl -X POST "https://locraft.cn/api/tuchuang/delete" \
  -H "Content-Type: application/json" \
  -d "{\"files\": [\"a.png\", \"b.png\"]}"

服务器状态图链接

第一个是全部服务器总览图，下面是每台服务器单独的图片（一图一台，内容包含在线状态、地址、版本、延迟、 在线人数、MOTD、在线玩家和近 24 小时人数趋势）。图片可以直接发到群里、嵌入网页或论坛。

![LOcraft 全部服务器（总览）](https://locraft.cn/api/server_status_image)

![GTNH 主线路（单服务器）](https://locraft.cn/api/server_status_image/2)

![原版 SMP（单服务器）](https://locraft.cn/api/server_status_image/6)

![GTNH 山东线路（单服务器）](https://locraft.cn/api/server_status_image/7)

![GTNH 江苏线路（单服务器）](https://locraft.cn/api/server_status_image/8)

![GTNH 广东线路（单服务器）](https://locraft.cn/api/server_status_image/9)

![GTNH 德国线路（单服务器）](https://locraft.cn/api/server_status_image/10)

![GTO 主线路（单服务器）](https://locraft.cn/api/server_status_image/11)

![GTO 备用线路（单服务器）](https://locraft.cn/api/server_status_image/12)

![GTNH主线（单服务器）](https://locraft.cn/api/server_status_image/13)

调用示例

# 服务器信息（含实时在线状态）
curl "https://locraft.cn/api/server_info"

# 只要静态信息，响应更快
curl "https://locraft.cn/api/server_info?status=0"

# 赞助信息，最近 10 条
curl "https://locraft.cn/api/donate_info?limit=10"

# 服务器状态图：直接返回一张 PNG 长图，可以发群 / 嵌入网页
curl -o status.png "https://locraft.cn/api/server_status_image"

# 只要某一台服务器的图（换成对应 id 或名称即可）
curl -o server3.png "https://locraft.cn/api/server_status_image/3"
curl -o gtL.png "https://locraft.cn/api/server_status_image?server=GTL"

# 深色版 + 强制刷新 + 不画玩家名单
curl -o status.png "https://locraft.cn/api/server_status_image?theme=dark&refresh=1&players=0"

# 只要图片直链，附带 Markdown / HTML / BBCode 现成写法
curl "https://locraft.cn/api/server_status_image?format=json"

const res = await fetch("https://locraft.cn/api/server_info?status=0");
const data = await res.json();
console.log(data.summary.online, "/", data.summary.total);