小小素API文档 上次更新: 2026-10-08
普通请求存在频率限制，可向开发者申请令牌。
/mcping、/org 为 v1 时期接口，因外部调用较多，暂时保留并内部转发至 v2。
请尽快迁移至 /v2/mcping、/v2/org。
通用状态码
| HTTP状态码 | Code | 描述 |
|---|---|---|
| 200 | 10000 | 请求成功 |
| 429 | 10004 | 请求过于频繁 |
| 503 | 10005 | 服务器繁忙 |
| 400 | 10101 | 缺少参数 |
| 403 | 10102 | 权限不足 |
| 404 | 10103 | 内容不存在 |
| 401 | 10104 | 认证失败 |
| 451 | 10105 | 因法律原因被禁止访问 |
| 500 | 10201 | 内部错误 |
| 500 | 10202 | 服务不可用 |
MCPing
GET/v2/mcping/json
返回指定MC服务器的Ping信息(JSON)
请求参数
ip - 服务器地址
请求示例
GET/v2/mcping/image
返回指定MC服务器的Ping信息(图片)
请求参数
ip - 服务器地址
watermark - 自定义水印文字(可选)
ip2 - 服务器地址2(可选)
watermark2 - 自定义水印文字2(可选)
请求示例
状态码
| HTTP状态码 | Code | 描述 |
|---|---|---|
| 400 | 13100 | 其他查询错误 |
| 400 | 13101 | 连接被拒绝 |
| 400 | 13102 | 连接超时 |
| 400 | 13103 | DNS解析失败 |
| 400 | 13104 | 建立连接但无数据 |
| 400 | 13105 | 连接被关闭 |
| 403 | 13106 | 该地址被列入黑名单 |
Skin
GET/v2/skin_lib/file
返回由玩家自行上传的皮肤文件，若没有上传皮肤，正版ID返回正版皮肤，非正版ID返回一个默认皮肤。
请求参数
player - 玩家
请求示例
状态码
| HTTP状态码 | Code | 描述 |
|---|---|---|
| 200 | 14000 | 文件上传成功 |
| 400 | 14101 | 没有上传文件 |
| 400 | 14102 | 没有选择文件 |
| 400 | 14103 | 不支持的文件格式 |
| 400 | 14104 | 文件太大 |
| 400 | 14105 | 文件安全验证失败 |
| 500 | 14201 | 文件保存失败 |
| 500 | 14202 | 服务端缺失必要文件 |
2B2T.ORG
GET/v2/org/tablist/image
返回2b2t.org当前在线玩家列表(图片)
GET/v2/org/rankings/playtime/image
返回2b2t.org近一个月在线时长排行榜前20名(图片)
GET/v2/org/rankings/kills/image
返回2b2t.org近一个月击杀数排行榜前20名(图片)
GET/v2/org/rankings/deaths/image
返回2b2t.org近一个月死亡数排行榜前20名(图片)
GET/v2/org/rankings/playtime/json
返回指定玩家在2b2t.org近一个月在线时长的排名信息
请求参数
player - 玩家ID
GET/v2/org/rankings/kills/json
返回指定玩家在2b2t.org近一个月击杀数的排名信息
请求参数
player - 玩家ID
GET/v2/org/rankings/deaths/json
返回指定玩家在2b2t.org近一个月死亡数的排名信息
请求参数
player - 玩家ID
GET/v2/org/rankings/all/json
返回指定玩家在2b2t.org近一个月的全部排名信息
请求参数
player - 玩家ID
状态码
| HTTP状态码 | Code | 描述 |
|---|---|---|
| 200 | 12101 | 玩家未上榜 |
| 500 | 12201 | 数据获取失败 |
| 500 | 12202 | 上游服务请求失败 |