API 接口文档

提供丰富的API服务，支持多种数据格式和调用方式

💬 随机消息API

获取随机一条消息（其中会有程序猿搞笑对话）

GET Endpoint: GET /api.php/message

示例:

cmd REM 获取随机消息 curl "http://craftserverlauncher.skytechstudio.top/api.php/message"

返回示例:

JSON响应 { "message": "随机选择的一句话" }

测试结果

点击按钮测试API...

🎮 MC图片API

获取随机MC图片URL

GET Endpoint: GET /api.php/background

API示例:

获取MC图片URL

cmd curl "http://craftserverlauncher.skytechstudio.top/api.php/background"

JavaScript示例:

javascript fetch('http://craftserverlauncher.skytechstudio.top/api.php/background') .then(response => response.json())) .then(data => console.log(data.BackGround_url))) // 使用示例) document.body.style.backgroundImage = `url(${data.BackGround_url})`;

Python示例:

python import requests response = requests.get('http://craftserverlauncher.skytechstudio.top/api.php/background')) data = response.json() print("MC图片URL:", data['BackGround_url'])

网页测试

测试结果

原始响应:

点击按钮测试API...

图片预览:

返回格式:

JSON响应 { "BackGround_url": "http://example.com/Data/api/backgrounds/image.jpg" }

注意事项:

  • 返回JSON格式数据，包含图片URL
  • 支持jpg/png/gif格式
  • URL可直接用于img标签或CSS背景
  • 错误时返回格式：{"error": "错误信息"}

使用示例:

JavaScript示例 fetch('/api.php/background') .then(response => response.text()) .then(url => { document.body.style.backgroundImage = `url(${url})`; });

📅 历史上的今天API

获取历史上的今天发生的重要事件

接口地址: http://craftserverlauncher.skytechstudio.top/api.php/history 请求方式: GET 返回格式: JSON

请求参数:

参数名 类型 必填 说明
date string 否 指定日期，格式：MM-DD，不传则使用今天
limit number 否 返回事件数量限制，默认10条

请求示例:

GET curl "http://craftserverlauncher.skytechstudio.top/api.php/history"
GET curl "http://craftserverlauncher.skytechstudio.top/api.php/history?date=01-01&limit=5"
JavaScript fetch('http://craftserverlauncher.skytechstudio.top/api.php/history') .then(response => response.json()) .then(data => console.log(data))

返回示例:

JSON响应 { "success": true, "date": "08-07", "year": 2025, "events": [ { "year": 1420, "title": "北京紫禁城开始建造", "desc": "明成祖朱棣下令开始建造紫禁城，历时14年完工" }, { "year": 1927, "title": "南昌起义爆发", "desc": "中国共产党领导的第一次武装起义在南昌爆发" } ], "total": 2, "message": "获取成功" }

返回字段说明:

字段名 类型 说明
success boolean 请求是否成功
date string 查询的日期（MM-DD格式）
year number 当前年份
events array 历史事件列表
events[].year number 事件发生年份
events[].title string 事件标题
events[].desc string 事件详细描述
total number 返回的事件总数
message string 响应消息

测试结果

点击按钮测试API...
↑ 返回导航

⛏️ MC用户信息API

用途: 获取玩家信息，包括UUID、历史用户名、皮肤等 接口地址: http://craftserverlauncher.skytechstudio.top/api.php/mc_info 请求方式: GET / POST 返回格式: JSON

⛏️ 功能特性:

  • 多功能集成: 一个API获取玩家的所有信息
  • 官方数据源: 直接从Mojang官方API获取数据
  • 历史记录: 获取玩家的历史用户名变更记录
  • 皮肤信息: 自动解析并提供皮肤和披风URL

请求参数:

参数名 类型 必填 说明
player string 否 玩家名称（用于获取完整信息或UUID）
uuid string 否 玩家UUID（用于获取历史记录或资料）
base64 string 否 Base64纹理数据（用于解析皮肤URL）
action string 否 操作类型：info(默认)、uuid、history、profile、texture

操作类型说明:

  • info: 获取玩家完整信息（默认）
  • uuid: 仅获取玩家UUID
  • history: 获取历史用户名
  • profile: 获取玩家资料和皮肤
  • texture: 解析Base64纹理数据，提取皮肤URL

请求示例:

获取完整信息 curl "http://craftserverlauncher.skytechstudio.top/api.php/mc_info?player=jeb_"
仅获取UUID curl "http://craftserverlauncher.skytechstudio.top/api.php/mc_info?player=jeb_&action=uuid"
获取历史用户名 curl "http://craftserverlauncher.skytechstudio.top/api.php/mc_info?uuid=853c80ef3c3749fdaa49938b674adae6&action=history"
解析Base64纹理数据 curl "http://craftserverlauncher.skytechstudio.top/api.php/mc_info?base64=eyJ0aW1lc3RhbXAiOjE2...&action=texture"
JavaScript示例 fetch('http://craftserverlauncher.skytechstudio.top/api.php/mc_info?player=jeb_') .then(response => response.json()) .then(data => console.log(data))
POST请求示例 fetch('http://craftserverlauncher.skytechstudio.top/api.php/mc_info', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ player: 'jeb_', action: 'info' }) }).then(response => response.json()) .then(data => console.log(data))

完整信息返回示例:

JSON响应 { "success": true, "player_name": "jeb_", "uuid": "853c80ef3c3749fdaa49938b674adae6", "formatted_uuid": "853c80ef-3c37-49fd-aa49-938b674adae6", "skin_url": "http://textures.minecraft.net/texture/...", "profile": { "success": true, "name": "jeb_", "uuid": "853c80ef3c3749fdaa49938b674adae6", "formatted_uuid": "853c80ef-3c37-49fd-aa49-938b674adae6", "skin_url": "http://textures.minecraft.net/texture/...", "textures": { ... } }, "history": { "success": true, "current_name": "jeb_", "uuid": "853c80ef-3c37-49fd-aa49-938b674adae6", "name_changes": 1, "history": [ { "name": "jeb_", "changedToAt": "" } ] } }

UUID获取返回示例:

JSON响应 { "success": true, "name": "jeb_", "uuid": "853c80ef3c3749fdaa49938b674adae6", "formatted_uuid": "853c80ef-3c37-49fd-aa49-938b674adae6" }

Base64纹理解析返回示例:

JSON响应 { "success": true, "raw_base64": "eyJ0aW1lc3RhbXAiOjE2...", "decoded_json": "{\"timestamp\":1640995200000,\"profileId\":\"853c80ef3c3749fdaa49938b674adae6\",\"profileName\":\"jeb_\",\"textures\":{\"SKIN\":{\"url\":\"http://textures.minecraft.net/texture/...\"}}}", "timestamp": 1640995200000, "date": "2022-01-01 00:00:00", "profile_id": "853c80ef3c3749fdaa49938b674adae6", "formatted_profile_id": "853c80ef-3c37-49fd-aa49-938b674adae6", "profile_name": "jeb_", "skin": { "url": "http://textures.minecraft.net/texture/...", "model": "steve" }, "cape": { "url": "http://textures.minecraft.net/texture/..." } }

Base64解析说明:

💡 使用提示:

  • Base64数据来自Mojang API的properties[0].value字段
  • 解码后包含玩家的皮肤和披风URL
  • 支持史蒂夫(steve)和亚历克斯(alex)皮肤模型检测
  • 自动提取时间戳和玩家ID信息

错误返回示例:

JSON响应 { "success": false, "error": "Player not found", "message": "玩家不存在" }

返回字段说明:

字段名 类型 说明
success boolean 请求是否成功
player_name string 玩家当前用户名
uuid string 玩家UUID（无连字符）
formatted_uuid string 格式化的UUID（带连字符）
skin_url string 玩家皮肤URL
cape_url string 玩家披风URL（如果有）
profile object 玩家详细资料
history object 历史用户名记录


测试结果

点击按钮测试API...

🖥️ MC服务器API

用途: 获取Minecraft服务器的详细状态信息，支持Java版和基岩版 接口地址: http://craftserverlauncher.skytechstudio.top/api.php/mc_server 请求方式: GET / POST 返回格式: JSON

🖥️ 功能特性:

  • 多版本支持: 支持Java版和基岩版服务器查询
  • 详细信息: 获取在线玩家、版本、MOTD、插件等信息
  • 批量查询: 支持一次查询多个服务器状态
  • 历史数据: 获取服务器的简化历史信息
  • 图标处理: 自动将Base64图标转换为可直接访问的URL

请求参数:

参数名 类型 必填 说明
server string 是 服务器地址（IP或域名）
port number 否 服务器端口（默认25565）
type string 否 服务器类型：java(默认)、bedrock、history
servers array 否 批量查询的服务器列表（POST请求）

服务器类型说明:

  • java: Java版服务器（默认）
  • bedrock: 基岩版服务器
  • history: 获取服务器简化历史信息

图标处理说明:

🖼️ 图标功能:

  • 自动将服务器的Base64图标保存为PNG文件
  • 提供可直接访问的图标URL
  • 图标文件自动缓存，24小时后清理
  • 支持标准的64x64像素服务器图标

请求示例:

Java版服务器 curl "http://craftserverlauncher.skytechstudio.top/api.php/mc_server?server=hypixel.net"
基岩版服务器 curl "http://craftserverlauncher.skytechstudio.top/api.php/mc_server?server=mco.mineplex.com&port=19132&type=bedrock"
指定端口 curl "http://craftserverlauncher.skytechstudio.top/api.php/mc_server?server=play.example.com&port=25566"
批量查询（POST） curl -X POST -H "Content-Type: application/json" \ -d '{"servers":[{"host":"hypixel.net","port":25565,"type":"java"},{"host":"mco.mineplex.com","port":19132,"type":"bedrock"}]}' \ "http://craftserverlauncher.skytechstudio.top/api.php/mc_server"
JavaScript示例 fetch('http://craftserverlauncher.skytechstudio.top/api.php/mc_server?server=hypixel.net') .then(response => response.json()) .then(data => { console.log(data); // 使用服务器图标 if (data.icon_url) { document.getElementById('serverIcon').src = data.icon_url; } })

成功返回示例:

JSON响应 { "success": true, "server": "hypixel.net", "port": 25565, "online": true, "hostname": "Hypixel Network", "version": "1.8.x-1.20.x", "protocol": 47, "players": { "online": 45678, "max": 200000, "list": [] }, "motd": { "raw": ["§aHypixel Network §c[1.8-1.20]", "§b§lNEW §6§lBED WARS PRACTICE MODE"], "clean": ["Hypixel Network [1.8-1.20]", "NEW BED WARS PRACTICE MODE"], "html": ["Hypixel Network [1.8-1.20]", "NEW BED WARS PRACTICE MODE"] }, "icon_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAA...", "icon_url": "http://your-domain/api.php/mc_icon?icon=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6.png", "software": "BungeeCord 1.19-R0.1-SNAPSHOT", "plugins": { "names": ["PluginName1", "PluginName2"], "raw": ["PluginName1 v1.0", "PluginName2 v2.1"] }, "query_time": "2024-01-01 12:00:00" }

基岩版返回示例:

JSON响应 { "success": true, "server": "mco.mineplex.com", "port": 19132, "type": "bedrock", "online": true, "hostname": "Mineplex", "version": "1.20.1", "players": { "online": 1234, "max": 40000 }, "motd": { "raw": ["Mineplex Network"], "clean": ["Mineplex Network"] }, "gamemode": "Survival", "server_id": "12345678901234567890", "map": "Mineplex Lobby", "query_time": "2024-01-01 12:00:00" }

批量查询返回示例:

JSON响应 { "success": true, "total_servers": 2, "results": [ { "success": true, "server": "hypixel.net", "port": 25565, "online": true, "players": {"online": 45678, "max": 200000} }, { "success": true, "server": "mco.mineplex.com", "port": 19132, "type": "bedrock", "online": true, "players": {"online": 1234, "max": 40000} } ], "query_time": "2024-01-01 12:00:00" }

错误返回示例:

JSON响应 { "success": false, "error": "Server offline or unreachable", "message": "服务器离线或无法访问", "server": "offline.example.com", "port": 25565 }

返回字段说明:

字段名 类型 说明
success boolean 请求是否成功
online boolean 服务器是否在线
hostname string 服务器名称
version string 服务器版本
players.online number 在线玩家数
players.max number 最大玩家数
players.list array 在线玩家列表（如果可用）
motd object 服务器描述信息
icon_base64 string 服务器图标（Base64格式）
icon_url string 服务器图标URL（可直接访问）
software string 服务器软件信息
plugins object 插件列表（如果可用）

测试结果

点击按钮测试API...

👤 用户注册/登录API

注册新用户或登录已有用户，支持用户名或邮箱登录

注册: POST /api.php/user?action=register

登录: POST /api.php/user?action=login

注意：请求需在 Authorization 请求头中加入 Data/config/key.oem 文件中的密码值（如 SkyTechStuido_dev.0705），否则无法通过认证。

登录请求参数:

字段名 类型 必填 说明
username string 是 用户名或邮箱地址
password string 是 注册时使用的密码

注册请求参数:

字段名 类型 必填 说明
username string 是 用户名，必须唯一
password string 是 用户密码
nickname string 是 用户昵称，可以包含中文、字母、数字、下划线和短横线
qq string 否 QQ号，5-11位数字（可选）
email string 是 邮箱地址，必须是有效的邮箱格式

登录成功响应:

字段名 类型 说明
success boolean 登录是否成功
message string 登录结果消息
username string 登录的用户名
nickname string 用户昵称
qq string 用户QQ号
email string 用户邮箱地址
created_at string 账号创建时间

登录失败响应:

字段名 类型 说明
success boolean 登录是否成功
error string 错误信息
message string 登录结果消息

注册请求示例:

bash # 注册请求 curl -X POST http://craftserverlauncher.skytechstudio.top/api.php/user?action=register \ -H "Authorization: SkyTechStuido_dev.0705" \ -H "Content-Type: application/json" \ -d "{\"username\":\"testuser\",\"password\":\"123456\",\"nickname\":\"测试用户\",\"qq\":\"123456789\",\"email\":\"test@example.com\"}"

登录请求示例:

bash # 登录请求 curl -X POST http://craftserverlauncher.skytechstudio.top/api.php/user?action=login \ -H "Authorization: SkyTechStuido_dev.0705" \ -H "Content-Type: application/json" \ -d "{\"username\":\"testuser\",\"password\":\"123456\"}" # 使用邮箱登录 curl -X POST http://craftserverlauncher.skytechstudio.top/api.php/user?action=login \ -H "Authorization: SkyTechStuido_dev.0705" \ -H "Content-Type: application/json" \ -d "{\"username\":\"test@example.com\",\"password\":\"123456\"}"

JavaScript登录示例:

javascript // 登录请求 fetch('http://craftserverlauncher.skytechstudio.top/api.php/user?action=login', { method: 'POST', headers: { 'Authorization': 'SkyTechStuido_dev.0705', 'Content-Type': 'application/json' }, body: JSON.stringify({ username: 'test', password: '123456' }) }) .then(response => response.json()) .then(data => console.log(data));

Python登录示例:

python # 登录请求 import requests url = 'http://craftserverlauncher.skytechstudio.top/api.php/user?action=login' headers = { 'Authorization': 'SkyTechStuido_dev.0705', 'Content-Type': 'application/json' } data = { 'username': 'test', 'password': '123456' } response = requests.post(url, headers=headers, json=data) print(response.json())

JavaScript注册示例:

javascript // 注册请求 fetch('http://craftserverlauncher.skytechstudio.top/api.php/user?action=register', { method: 'POST', headers: { 'Authorization': 'SkyTechStuido_dev.0705', 'Content-Type': 'application/json' }, body: JSON.stringify({ username: 'test', password: '123456', nickname: '中文昵称', qq: '123456789' }) }) .then(response => response.json()) .then(data => console.log(data));

Python注册示例:

python # 注册请求 import requests url = 'http://yourdomain.com/api.php/user?action=register' headers = { 'Authorization': 'YOUR_API_KEY', 'Content-Type': 'application/json' } data = { 'username': 'test', 'password': '123456', 'nickname': '中文昵称', 'qq': '123456789' } response = requests.post(url, headers=headers, json=data) print(response.json())

CMD注册示例(单行):

cmd REM 注册请求 curl -X POST "http://craftserverlauncher.skytechstudio.top/api.php/user?action=register" -H "Authorization: SkyTechStuido_dev.0705" -H "Content-Type: application/json" -d "{\"username\":\"testuser\",\"password\":\"123456\",\"nickname\":\"测试用户\",\"qq\":\"123456789\",\"email\":\"test@example.com\"}"

CMD登录示例(单行):

cmd REM 登录请求 curl -X POST "http://craftserverlauncher.skytechstudio.top/api.php/user?action=login" -H "Authorization: SkyTechStuido_dev.0705" -H "Content-Type: application/json" -d "{\"username\":\"testuser\",\"password\":\"123456\"}"

注意事项:

  • 确保使用双引号包裹JSON键名
  • 字符串值必须用双引号包裹
  • 避免外层单引号包裹JSON
  • 复杂数据结构必须使用标准JSON格式
  • 注册时必须包含username, password和nickname三个字段
  • 登录时只需username和password字段

返回响应格式:

字段名 类型 说明 示例值
success boolean 操作是否成功 true
message string 操作结果消息 "注册成功"
error string 错误信息(失败时) "用户名已存在"
username string 用户名(成功时) "testuser"
nickname string 用户昵称(成功时) "用户昵称"
qq string 用户QQ号(成功时) "12345678"
email string 用户邮箱(成功时) "user@example.com"
created_at string 创建时间(成功时) "2025-08-06 23:11:25"

成功响应示例:

{
  "success": true,
  "message": "注册成功",
  "username": "testuser",
  "nickname": "用户昵称",
  "qq": "123456789",
  "created_at": "2025-08-06 23:11:25"
}

登录成功响应示例:

{
  "success": true,
  "message": "Login successful",
  "username": "testuser",
  "nickname": "用户昵称",
  "qq": "123456789",
  "created_at": "2025-08-06 23:11:25"
}

错误响应示例:

{
  "success": false,
  "error": "用户名已存在",
  "message": "注册失败"
}

说明:

  • 注册时用户名、密码、昵称和邮箱为必填，QQ号为可选
  • 登录时只需要用户名/邮箱和密码
  • 昵称可以重复，但用户名和邮箱必须唯一
  • 注册成功后可用用户名或邮箱登录
  • 登录和注册成功响应都会返回用户信息，包括用户名、昵称和创建时间
  • 所有数据仅用于演示，实际生产请用数据库

网页测试

测试结果

点击按钮测试API...

🌐 翻译API

用途: API简介: 三重保障专业翻译接口，支持100+种语言互译 接口地址: http://craftserverlauncher.skytechstudio.top/api.php/fanyi 请求方式: GET / POST 返回格式: JSON

📋 服务特性:<

  • 三重保障: 使用AppWorlds、SUAPI、QVQA三个专业翻译服务，确保高可用性
  • 广泛支持: 支持100+种语言互译，覆盖世界主要语言
  • 智能切换: 检测到API限制时自动切换服务，无需等待
  • 限制检测: 自动识别"今日调用已达上限"、"文本过长"等限制提示，立即切换API
  • 长度适配: 根据文本长度自动选择合适的API服务
  • 兼容性强: 支持多种参数格式，兼容旧版本API

请求参数:

参数名 类型 必填 说明
text string 是 需要翻译的文本
source string 是 源语言代码
target string 是 目标语言代码

请求限制:

  • 请求频率：2秒1次
  • 文本长度：最大1000个字符（智能适配不同API限制）
  • 日请求量：不超过1000次
  • 支持GET和POST请求方式

各API文本长度限制:

  • AppWorlds: 最大255个字符
  • SUAPI: 最大1000个字符
  • QVQA: 最大500个字符
  • 智能切换: 超过长度限制时自动切换到支持更长文本的API

请求示例:

GET curl "http://craftserverlauncher.skytechstudio.top/api.php/fanyi?text=你好&source=zh&target=en"
JavaScript fetch('http://craftserverlauncher.skytechstudio.top/api.php/fanyi?text=你好&source=zh&target=en') .then(response => response.json()) .then(data => console.log(data))
Python import requests response = requests.get('http://craftserverlauncher.skytechstudio.top/api.php/fanyi?text=你好&source=zh&target=en') data = response.json() print(data)
PHP $url = 'http://craftserverlauncher.skytechstudio.top/api.php/fanyi?text=你好&source=zh&target=en'; $response = file_get_contents($url); $data = json_decode($response, true); print_r($data);
Node.js const axios = require('axios'); axios.get('http://craftserverlauncher.skytechstudio.top/api.php/fanyi?text=你好&source=zh&target=en') .then(response => console.log(response.data)) .catch(error => console.error(error));

POST请求示例:

JavaScript POST fetch('http://craftserverlauncher.skytechstudio.top/api.php/fanyi', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ text: '你好', source: 'zh', target: 'en' }) }).then(response => response.json()) .then(data => console.log(data))
Python POST import requests import json url = 'http://craftserverlauncher.skytechstudio.top/api.php/fanyi' data = { 'text': '你好', 'source': 'zh', 'target': 'en' } response = requests.post(url, json=data) print(response.json())

兼容旧版本参数:

旧版本兼容 # 支持旧版本的msg和type参数 curl "http://craftserverlauncher.skytechstudio.top/api.php/fanyi?msg=你好&type=1" # type=1: 中→英, type=2: 英→中
from/to参数 # 也支持from/to参数格式 curl "http://craftserverlauncher.skytechstudio.top/api.php/fanyi?text=你好&from=zh&to=en"

成功返回示例:

JSON响应 { "success": true, "translation": "Hello", "original_text": "你好", "source": "zh", "target": "en", "service_used": "appworlds", "message": "Translation successful" }

备用服务返回示例:

JSON响应 { "success": true, "translation": "Hello", "original_text": "你好", "source": "zh", "target": "en", "service_used": "suapi", "message": "Translation successful" }

第二备用服务返回示例:

JSON响应 { "success": true, "translation": "Hello", "original_text": "你好", "source": "zh", "target": "en", "service_used": "qvqa", "message": "Translation successful" }

智能切换成功示例:

JSON响应 { "success": true, "translation": "Hello", "original_text": "你好", "source": "zh", "target": "en", "service_used": "suapi", "attempted_services": ["appworlds", "suapi"], "note": "经过服务切换后翻译成功", "message": "Translation successful" }

错误返回示例:

{
  "success": false,
  "error": "Translation failed",
  "message": "翻译失败",
  "original_text": "你好",
  "source": "zh",
  "target": "en",
  "service_attempted": "qvqa",
  "attempted_services": ["appworlds", "suapi", "qvqa"],
  "note": "所有翻译服务都不可用或达到使用限制"
}

限制检测错误示例:

{
  "success": false,
  "error": "今日调用已达上限，请明日再试",
  "message": "翻译失败",
  "original_text": "你好",
  "source": "zh",
  "target": "en",
  "service_attempted": "qvqa",
  "attempted_services": ["appworlds", "suapi", "qvqa"],
  "rate_limit_detected": true,
  "note": "检测到API使用限制，已尝试切换服务但均不可用"
}

文本长度限制错误示例:

{
  "success": false,
  "error": "QVQA文本长度超过500个字符限制",
  "message": "翻译失败",
  "original_text": "很长的文本...",
  "source": "zh",
  "target": "en",
  "service_attempted": "qvqa",
  "attempted_services": ["appworlds", "suapi", "qvqa"],
  "text_length_limit": true,
  "text_length": 800,
  "api_limits": {
    "appworlds": 255,
    "suapi": 1000,
    "qvqa": 500
  },
  "switch_reason": "文本长度800字符超过qvqaAPI的500字符限制，自动切换到下一个API",
  "note": "文本长度超过所有API的支持范围，请缩短文本后重试"
}

服务说明:

  • appworlds: AppWorlds翻译接口 (translate.appworlds.cn) - 主要服务，支持100+种语言
  • suapi: SUAPI翻译接口 (suapi.net) - 第一备用服务，支持多种语言和自动语言检测
  • qvqa: QVQA翻译接口 (api.qvqa.cn) - 第二备用服务，支持13种主要语言
  • 高质量翻译: 基于先进的翻译算法，提供准确的翻译结果
  • 实时翻译: 快速响应，支持实时翻译需求

支持的语言代码:

语言 代码 语言 代码
中文zh英语en
日语ja韩语ko
法语fr德语de
西班牙语es俄语ru
意大利语it葡萄牙语pt
阿拉伯语ar荷兰语nl
土耳其语tr越南语vi
印尼语id马来语ms
繁体中文zh-tw等更多语言
注意：不同服务支持的语言略有差异
AppWorlds支持100+种语言，SUAPI支持多种语言，QVQA支持13种主要语言
→

测试结果

点击按钮测试API...

🌍 IP地址查询API

查询IP地址的归属地信息

Endpoint: GET /api.php/ip

参数说明:

  • ip: IP地址(可选，不传则自动检测请求IP)

示例:

cmd curl http://craftserverlauncher.skytechstudio.top/api.php/ip curl http://craftserverlauncher.skytechstudio.top/api.php/ip?ip=223.5.5.5

返回值说明:

字段名 类型 说明 示例值
code number 状态码 200
msg string 状态信息 "success"
data对象
data.ip string 查询的IP地址 "223.5.5.5"
data.country string 国家 "中国"
data.province string 省份 "北京市"
data.city string 城市 "北京市"
data.isp string 运营商 "阿里云"

返回示例:

{
  "code": 200,
  "data": {
    "ip": "223.5.5.5",
    "country": "中国",
    "province": "北京市",
    "city": "北京市",
    "isp": "阿里云"
  },
  "msg": "success"
}

测试结果

点击按钮测试API...

🐧 QQ头像API

用途: 获取指定QQ号的头像URL 接口地址: http://craftserverlauncher.skytechstudio.top/api.php/qq_avatar 请求方式: GET 返回格式: JSON

请求参数:

参数名 类型 必填 说明
qq string 是 QQ号，5-11位数字
size number 否 头像尺寸，支持40、100、140、640，默认100

请求示例:

GET curl "http://craftserverlauncher.skytechstudio.top/api.php/qq_avatar?qq=123456789"
GET curl "http://craftserverlauncher.skytechstudio.top/api.php/qq_avatar?qq=123456789&size=640"
JavaScript fetch('http://craftserverlauncher.skytechstudio.top/api.php/qq_avatar?qq=123456789') .then(response => response.json()) .then(data => console.log(data.avatar_url))

返回示例:

{
  "success": true,
  "qq": "123456789",
  "avatar_url": "https://q1.qlogo.cn/g?b=qq&nk=123456789&s=100",
  "size": 100,
  "message": "获取QQ头像成功"
}

返回字段说明:

字段名 类型 说明
success boolean 请求是否成功
qq string 查询的QQ号
avatar_url string QQ头像的URL地址
size number 头像尺寸
message string 响应消息

错误响应示例:

{
  "success": false,
  "error": "QQ号格式错误",
  "message": "QQ号必须是5-11位数字"
}

测试结果

点击按钮测试API...

头像预览:

🎲 随机字符串API

用途: 生成包含数字和大写字母的随机字符串 接口地址: http://craftserverlauncher.skytechstudio.top/api.php/random_string 请求方式: GET 返回格式: JSON

请求参数:

参数名 类型 必填 说明
length number 否 字符串长度，1-100之间，默认8
type string 否 字符类型：mixed(数字+大写字母)、numbers(仅数字)、letters(仅大写字母)，默认mixed

请求示例:

GET curl "http://craftserverlauncher.skytechstudio.top/api.php/random_string"
GET curl "http://craftserverlauncher.skytechstudio.top/api.php/random_string?length=16&type=mixed"
GET curl "http://craftserverlauncher.skytechstudio.top/api.php/random_string?length=10&type=numbers"
JavaScript fetch('http://craftserverlauncher.skytechstudio.top/api.php/random_string?length=12&type=mixed') .then(response => response.json()) .then(data => console.log(data.random_string))

返回示例:

{
  "success": true,
  "random_string": "A7B9C2D8E1F3",
  "length": 12,
  "type": "mixed",
  "type_name": "数字+大写字母",
  "character_set": "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ",
  "message": "随机字符串生成成功"
}

返回字段说明:

字段名 类型 说明
success boolean 请求是否成功
random_string string 生成的随机字符串
length number 字符串长度
type string 字符类型
type_name string 字符类型中文名称
character_set string 使用的字符集
message string 响应消息

类型说明:

  • mixed: 数字(0-9) + 大写字母(A-Z)，共36个字符
  • numbers: 仅数字(0-9)，共10个字符
  • letters: 仅大写字母(A-Z)，共26个字符

错误响应示例:

{
  "success": false,
  "error": "长度参数错误",
  "message": "长度必须在1-100之间"
}

测试结果

点击按钮测试API...

生成的随机字符串:

🌤️ 天气API

用途: 获取实时天气和预报信息 Endpoint: GET /api.php/weather

示例:

cmd REM 获取天气信息 curl "http://craftserverlauncher.skytechstudio.top/api.php/weather"
cmd REM 获取指定城市天气信息 curl "http://craftserverlauncher.skytechstudio.top/api.php/weather?city=110101&extensions=all"
参数说明: city : 城市adcode编码(可选，不传则自动根据IP定位) extensions : 气象类型(base:实况天气, all:预报天气)

返回值说明:

基础信息
字段名 类型 描述 示例
status 字符串 请求状态，1表示成功，0表示失败 "1"
count 字符串 返回结果数量 "1"
info 字符串 状态信息 "OK"
infocode 字符串 状态码 "10000"
实况天气数据 (lives)
字段名 类型 描述 示例
province 字符串 省份名称 "北京市"
city 字符串 城市名称 "北京市"
adcode 字符串 区域编码 "110000"
weather 字符串 天气现象 "晴"
temperature 字符串 实时气温，单位：摄氏度 "25"
winddirection 字符串 风向 "西北"
windpower 字符串 风力等级 "3"
humidity 字符串 空气湿度 "40"
reporttime 字符串 数据发布时间 "2023-05-01 12:30:00"
预报天气数据 (forecasts, 当extensions=all时返回)
字段名 类型 描述 示例
city 字符串 城市名称 "北京市"
adcode 字符串 区域编码 "110000"
province 字符串 省份名称 "北京市"
reporttime 字符串 数据发布时间 "2023-05-01 12:30:00"
预报详情 (casts)
date 字符串 日期 "2023-05-01"
week 字符串 星期几 "1"
dayweather 字符串 白天天气现象 "晴"
nightweather 字符串 夜间天气现象 "晴"
daytemp 字符串 白天温度 "28"
nighttemp 字符串 夜间温度 "15"
daywind 字符串 白天风向 "西北"
nightwind 字符串 夜间风向 "西北"
daypower 字符串 白天风力 "3"
nightpower 字符串 夜间风力 "1"

测试结果

点击按钮测试API...