小小素API文档 上次更新: 2025-10-28
公开本API提供的数据应标注来源：本站/开发者Github/开发者B站。普通请求存在频率限制，可向开发者申请认证请求，认证请求调用方式。
通用状态码
| HTTP状态码 | Code | 描述 |
|---|---|---|
| 200 | 10000 | 请求成功 |
| 429 | 10004 | 请求过于频繁 |
| 503 | 10005 | 服务器繁忙 |
| 400 | 10101 | 缺少参数 |
| 403 | 10102 | 权限不足 |
| 404 | 10103 | 内容不存在 |
| 401 | 10104 | 认证失败 |
| 451 | 10105 | 因法律原因被禁止访问 |
| 500 | 10201 | 内部错误 |
| 500 | 10202 | 服务不可用 |
MCPing
GET/mcping/json
返回指定MC服务器的Ping信息(JSON)
请求参数
ip - 服务器地址
请求示例
GET/mcping/image
返回指定MC服务器的Ping信息(图片)
请求参数
ip - 服务器地址
watermark - 自定义水印文字(可选)
请求示例
状态码
| HTTP状态码 | Code | 描述 |
|---|---|---|
| 400 | 13100 | 其他查询错误 |
| 400 | 13101 | 连接被拒绝 |
| 400 | 13102 | 连接超时 |
| 400 | 13103 | DNS解析失败 |
| 400 | 13104 | 建立连接但无数据 |
| 400 | 13105 | 连接被关闭 |
| 403 | 13106 | 该地址被列入黑名单 |
Skin
GET/skin/file
返回指定ID由玩家上传的皮肤文件，若没有上传皮肤，正版ID返回正版皮肤，非正版ID返回菜鸟皮肤，用于azsu.top服务器设置皮肤功能。若SkinsRestorer插件无法识别请改为5003端口。【因DDoS攻击，SkinsRestorer插件专用接口(5003端口)已开启白名单，请联系开发者添加】
请求参数
player - 玩家ID
请求示例
状态码
| HTTP状态码 | Code | 描述 |
|---|---|---|
| 200 | 14000 | 文件上传成功 |
| 400 | 14101 | 没有上传文件 |
| 400 | 14102 | 没有选择文件 |
| 400 | 14103 | 不支持的文件格式 |
| 400 | 14104 | 文件太大 |
| 400 | 14105 | 文件安全验证失败 |
| 500 | 14201 | 文件保存失败 |
| 500 | 14202 | 服务端缺失必要文件 |
Whois
GET/whois/image
返回Whois查询图片
请求参数
domain - 域名
请求示例
状态码
| HTTP状态码 | Code | 描述 |
|---|---|---|
| 500 | 12203 | Whois查询错误 |
2B2T.ORG
GET/org/tablist/image
返回2b2t.org当前在线玩家列表(图片)
GET/org/rankings/playtime/image
返回2b2t.org近一个月在线时长排行榜前20名(图片)
GET/org/rankings/kills/image
返回2b2t.org近一个月击杀数排行榜前20名(图片)
GET/org/rankings/deaths/image
返回2b2t.org近一个月死亡数排行榜前20名(图片)
GET/org/rankings/playtime/json
返回指定玩家在2b2t.org近一个月在线时长的排名信息
请求参数
player - 玩家ID
GET/org/rankings/kills/json
返回指定玩家在2b2t.org近一个月击杀数的排名信息
请求参数
player - 玩家ID
GET/org/rankings/deaths/json
返回指定玩家在2b2t.org近一个月死亡数的排名信息
请求参数
player - 玩家ID
GET/org/rankings/all/json
返回指定玩家在2b2t.org近一个月的全部排名信息
请求参数
player - 玩家ID
状态码
| HTTP状态码 | Code | 描述 |
|---|---|---|
| 200 | 12101 | 玩家未上榜 |
| 500 | 12201 | 数据获取失败 |
| 500 | 12202 | 上游服务请求失败 |
2B2T.GG
GET/gg/tablist/json
返回2b2t.gg当前在线玩家列表(JSON)
GET/gg/tablist/image
返回2b2t.gg当前在线玩家列表(图片)
GET/gg/stats/<player_name>
返回指定玩家在2b2t.gg的信息
请求参数
player_name - 玩家ID
GET/gg/rankings/player/<player_name>
返回指定玩家在2b2t.gg的排名信息
请求参数
player_name - 玩家ID
GET/gg/rankings/json/<type>/<player_name>
返回指定玩家在2b2t.gg中指定类型的排名信息
请求参数
type - 类型：joins/kills/deaths/kd/playtime
player_name - 玩家ID
GET/gg/rankings/json/<type>
返回2b2t.gg中指定类型的排行榜前1000名
请求参数
type - 类型：joins/kills/deaths/kd/playtime
GET/gg/rankings/image/<type>
返回2b2t.gg中指定类型的排行榜前20名(图片)
请求参数
type - 类型：joins/kills/deaths/kd/playtime