HelloSkin API

🧑‍🔬 供开发者阅读的文章

如果你看不懂这个页面在说些什么，直接关闭这篇文章或者浏览其它文章即可。

忽略此文章并不会影响你正常使用 HelloSkin 的基础功能。

注意

当前 Blessing Skin API 和我们的部分 API 正处于试验阶段，API 不稳定并随时可能发生破坏性变更，敬请留意。

HelloSkin 使用 Blessing Skin 最新开发版本，支持通过 Blessing Skin API 使用 HelloSkin 的各种功能，包括但不限于获取角色信息、更改角色材质等。

除此之外，HelloSkin 有一些原版 Blessing Skin API 不具备的定制 API。

通常来说，此页面列出的大多数 API 均需鉴权。一些无需鉴权即可使用的 API 会被特别标出。

Blessing Skin API 文档

按理来说，HelloSkin 的 Blessing Skin API 与原版 Blessing Skin API 完全一致，你可以直接参考 Blessing Skin API 的文档：Blessing Skin 用户手册 - Web API。

除此之外，这里还有一些 Blessing Skin API 的文档中没有提到的，请求部分 API 时可能需要请求用户授予的权限：

权限节点	解释
`User.Read`	读取用户基本信息
`Player.Read` / `Player.ReadWrite`	读取 / 读写用户的角色和对应材质
`Closet.Read` / `Closet.ReadWrite`	读取 / 读写用户的衣柜收藏
`Notification.Read`	读取用户的站内通知

http

GET https://helloskin.cn/api/iploc/ HTTP/1.1
Accept: application/json | application/javascript | application/array | application/text

返回查询IP或本机IP的属地信息（为保护隐私，仅展示省份）

请求参数

参数名称	参数说明	请求类型	必须	类型
`ip`	指定查询IP地址	Params	false	String
`code`	指定接口输出格式	Params	false	String

支持的输出代码格式有：Json[默认留空]JavaScriptArrayText

响应说明

以下只是对 OpenAPI 文档的额外补充说明。

http

HTTP/1.1 200 OK
Content-Type: application/json


{
    "code": 200,
    "ip": "0.0.0.0",
    "ip_loc": "示例省份"
}