OakSkin API

OakSkin 皮肤站基于 Blessing Skin Server 开发，兼容其绝大多数 HTTP API。本文档列出常用接口，方便开发者接入。

基础信息

接口根地址：https://skin.oak-ms.top/api
所有接口默认返回 JSON 格式（Content-Type: application/json）
需要鉴权的接口在 HTTP Header 中携带：Authorization: Bearer <access_token>
匿名请求存在频率限制，如遇 429 请稍后重试或申请开发者凭证

角色查询（匿名）

按角色名获取 CSL 格式信息

GET https://skin.oak-ms.top/csl/{player_name}.json

兼容 CustomSkinLoader v14/v13 标准格式，直接返回该角色的皮肤与披风材质哈希。

按角色名获取皮肤 PNG（匿名）

GET https://skin.oak-ms.top/skin/{player_name}.png
GET https://skin.oak-ms.top/cape/{player_name}.png

用于兼容老式皮肤 API（部分插件 / Mod 默认使用此格式）。

按角色名获取完整材质信息（匿名）

GET https://skin.oak-ms.top/api/players/{player_name}

响应示例：

{
  "code": 0,
  "message": "success",
  "data": {
    "pid": 1234,
    "name": "Steve",
    "uid": 567,
    "tid_skin": "9a8b7c6d...",
    "tid_cape": null,
    "last_modified": "2026-08-01 12:00:00"
  }
}

用户接口（需 Token）

通过 OAuth2 获得 access_token 后可访问以下接口。

获取当前用户信息

GET https://skin.oak-ms.top/api/user

获取当前用户的全部角色

GET https://skin.oak-ms.top/api/players

获取指定材质的下载链接

GET https://skin.oak-ms.top/textures/{texture_id}

错误码

code	含义
0	成功
1	未授权（缺少或无效 Token）
1001	角色不存在
1002	材质不存在
2001	参数错误
429	触发频率限制

获取完整文档

如需更完整的 API 字段说明与新版 Blessing Skin v5+ 新增接口，请查阅 Blessing Skin 官方 API 文档，OakSkin 完全兼容。