跳到主要内容

角色

获取所有角色​

返回包含所有角色的列表。

GET /api/players

参数​

无。

响应​

Status: 200

[
  {
    "pid": 1,
    "uid": 1,
    "name": "my player",
    "tid_skin": 0,
    "tid_cape": 0,
    "last_modified": "2020-01-01 00:00:00"
  }
]

添加角色​

添加一个新的角色。

POST /api/players

参数​

名称类型描述
namestring必需。 角色名。

响应​

Status: 200

{
  "code": 0,
  "message": "<human-readable message>",
  "data": {
    "pid": 1,
    "uid": 1,
    "name": "my player",
    "tid_skin": 0,
    "tid_cape": 0,
    "last_modified": "2020-01-01 00:00:00"
  }
}

删除角色​

删除一个角色。

DELETE /api/players/{pid}

参数​

无。

响应​

Status: 200

{
  "code": 0,
  "message": "<human-readable message>"
}

更改角色名​

更改角色的名称。

PUT /api/players/{pid}/name

参数​

名称类型描述
namestring必需。 角色名。

响应​

Status: 200

{
  "code": 0,
  "message": "<human-readable message>",
  "data": {
    "pid": 1,
    "uid": 1,
    "name": "my player",
    "tid_skin": 0,
    "tid_cape": 0,
    "last_modified": "2020-01-01 00:00:00"
  }
}

更改角色材质​

可以单独更改角色的皮肤，也可以单独更改角色的披风，还可以同时更改皮肤和披风。

PUT /api/players/{pid}/textures

参数​

名称类型描述
skininteger希望应用到角色皮肤的材质 TID。
capeinteger希望应用到角色披风的材质 TID。

需要注意的是，skin 参数和 cape 参数可以同时出现，也可以不同时出现，但至少存在其中的一个。

响应​

Status: 200

{
  "code": 0,
  "message": "<human-readable message>",
  "data": {
    "pid": 1,
    "uid": 1,
    "name": "my player",
    "tid_skin": 1,
    "tid_cape": 2,
    "last_modified": "2020-01-01 00:00:00"
  }
}

重置角色材质​

重置角色的材质，可以单独重置皮肤或披风，也可以同时重置皮肤和披风。

DELETE /api/players/{pid}/textures

参数​

支持两个格式：

名称类型描述
type包含 string 的数组必需。 数组中的字符串只能为 skin 或 cape。数组必须包含 1 至 2 个元素。

或

名称类型描述
skinany使用此参数将会重置皮肤。
capeany使用此参数将会重置披风。