# 直播间用户实用 API | BAC Document
社区开源的第三方哔哩哔哩 API 文档

# 直播间用户实用 API

## 获取自己持有的粉丝勋章信息

> https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal (旧) https://api.live.bilibili.com/xlive/app-ucenter/v1/user/GetMyMedals

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

url 参数：

参数名 | 类型 | 内容 | 必要性 | 备注
--- | --- | --- | --- | ---
page_size | num | 每页的数量 | 必要 | 最大为 10，超出 `1002002：参数异常`
page | num | 返回结果页数 | 必要 | 两个参数不填返回空，只 page 不填或错误则 500 异常

json 回复：

根对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
code | num | 返回值 | 0：成功 -1002002：参数异常 -500：服务器异常
message | str | 错误信息 | 默认为 "0"
ttl | num | 1 |
data | obj | 信息本体 |

`data`对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
count | num | 勋章数量 |
items | array | 粉丝勋章信息本体 |
page_info | obj | 页码信息 |

`items`数组中的对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
can_delete | bool | 可否删除 |
day_limit | num | 日经验上限（原力值） | eg: 1500
guard_level | num |  |
guard_medal_title | str | 加成状态 |
intimacy | num | 当前已得亲密度 |
is_lighted | num | 是否点亮 | 0：未点亮 1：点亮
level | num | 勋章等级 |
medal_name | str | 勋章名 |
medal_color_border | num | 勋章边框颜色信息 | 颜色数值为 10 进制的 16 进制值（下同）
medal_color_start | num | 勋章起始颜色 | 从右往左渐变（20 级+勋章）
medal_color_end | num | 勋章结束颜色 | 从右往左渐变（20 级+勋章）
medal_id | num | 粉丝勋章 id |
next_intimacy | num | 升级所需经验 |
today_feed | num | 本日亲密度 |
roomid | num | 直播间房间号 |
status | num |  |
target_id | number | up 主 mid |
target_name | str | up 主用户名 |
uname | str | up 主用户名 |

`page_info`对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
total_page | num | 页码总长度 |
cur_page | num | 当前返回的页码 |

示例：

    curl https://api.live.bilibili.com/xlive/app-ucenter/v1/user/GetMyMedals?page=1&page_size=10 \
    -b "SESSDATA=xxx"

查看响应示例：

    {
      "code": 0,
      "message": "0",
      "ttl": 1,
      "data": {
        "items": [
          {
            "can_deleted": true,
            "day_limit": 1500,
            "guard_level": 0,
            "guard_medal_title": "未开启加成",
            "intimacy": 9617,
            "is_lighted": 0,
            "level": 11,
            "medal_name": "锦依卫",
            "medal_color_border": 12632256,
            "medal_color_end": 12632256,
            "medal_color_start": 12632256,
            "medal_id": 29245,
            "next_intimacy": 10000,
            "today_feed": 0,
            "roomid": 1546736,
            "status": 0,
            "target_id": 36081646,
            "target_name": "洛天依",
            "uname": "洛天依"
          }
        ],
        "page_info": {
          "cur_page": 1,
          "total_page": 1
        },
        "count": 1
      }
    }

## 佩戴勋章

> https://api.live.bilibili.com/xlive/web-room/v1/fansMedal/wear

请求方式：POST

表单参数：

参数名 | 类型 | 内容 | 必要性 | 备注
--- | --- | --- | --- | ---
medal_id | num | 勋章 id | 必要 |
csrf | num | cookie 中 bili_jct 字段 | 必要 |
csrf_token | num | 同上 | 必要 |

json 回复：

根对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
code | num | 返回值 | 0：成功
ttl | num | 1 |
message | str | 错误信息 | 默认为佩戴成功
data | obj | 信息本体 | 默认为无

示例：

佩戴勋章 id 为 1 的勋章

    var madelForm = new FormData();
    madelForm.append("medal_id", 1);
    madelForm.append("csrf", bili_jct);
    madelForm.append("csrf_token", bili_jct);
    $.ajax({
        url: "https://api.live.bilibili.com/xlive/web-room/v1/fansMedal/wear",
        type: "POST",
        data: madelForm,
        dataType: "JSON",
        processData: false,
        contentType: false,
        cache: false,
        xhrFields: {
            withCredentials: true
        },
        success: function (){

        }
    })

查看响应示例：

    {
      "code": 0,
      "message": "佩戴成功",
      "ttl": 1,
      "data": {}
    }

## 直播签到（已下线）

> https://api.live.bilibili.com/xlive/web-ucenter/v1/sign/DoSign

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

json 回复：

根对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
code | num | 返回值 | 0：成功 1：参数错误
ttl | num | 1 |
message | str | 错误信息 | 默认为当日签到奖励内容
data | obj | 信息本体 | 默认为空

（目前已下线）

查看响应示例（下线后）：

    {
        "code": 1,
        "message": "签到活动已下线，无法使用。",
        "ttl": 1,
        "data": null
    }

## 本月直播签到信息

> https://api.live.bilibili.com/xlive/web-ucenter/v1/sign/WebGetSignInfo

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

json 回复：

根对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
code | num | 返回值 | 0：成功
ttl | num | 1 |
message | str | 错误信息 | 默认为0
data | obj | 信息本体 |

`data`对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
text | str | 今日签到奖励信息 | 默认为空
specialText | str | 连续签到奖励信息 | 默认为空
status | num | 签到状态 | 0：未签到 1：已签到
allDays | num | 当月天数 |
curMonth | num | 当前月 |
curYear | num | 当前年 |
curDay | num | 当前日 |
curData | str | 当前日期（格式化） | eg: 2023-2-19
hadSignDays | num | 当月已签到天数 | 默认为0
newTask | num | 作用未知 | 默认为0
signDaysList | array | 当月已签到日列表 | 默认为空
signBonusDaysList | array | 当月已签到且有特殊奖励日列表 | 默认为空

查看响应示例：

    {
        "code": 0,
        "message": "0",
        "ttl": 1,
        "data": {
            "text": "3000点用户经验,2根辣条",
            "specialText": "再签到7天可以获得50根辣条",
            "status": 1,
            "allDays": 28,
            "curMonth": 2,
            "curYear": 2023,
            "curDay": 19,
            "curDate": "2023-2-19",
            "hadSignDays": 13,
            "newTask": 0,
            "signDaysList": [
                2,
                3,
                4,
                5,
                6,
                7,
                11,
                13,
                14,
                15,
                17,
                18,
                19
            ],
            "signBonusDaysList": [
                6
            ]
        }
    }

## 上月直播签到信息

> https://api.live.bilibili.com/sign/getLastMonthSignDays

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

json 回复：

根对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
code | num | 返回值 | 0：成功
ttl | num | 1 |
message | str | 错误信息 | 默认为0
data | obj | 信息本体 |

`data`对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
days | num | 上月天数 |
month | num | 上月月份值 |
hadSignDays | num | 上月已签到天数 | 默认为0
signDaysList | array | 上月已签到日列表 | 默认为空
signBonusDaysList | array | 上月已签到且有特殊奖励日列表 | 默认为空

查看响应示例：

    {
        "code": 0,
        "message": "0",
        "ttl": 1,
        "data": {
            "month": 1,
            "days": 31,
            "hadSignDays": 20,
            "signDaysList": [
                1,
                2,
                3,
                6,
                7,
                8,
                10,
                12,
                13,
                14,
                15,
                18,
                20,
                23,
                24,
                25,
                26,
                27,
                30,
                31
            ],
            "signBonusDaysList": [
                7,
                31
            ]
        }
    }

## 查询直播间贡献榜

> https://api.live.bilibili.com//xlive/general-interface/v1/rank/getOnlineGoldRank

请求方式：GET

认证方式：无

url 参数：

参数名 | 类型 | 内容 | 必要性 | 备注
--- | --- | --- | --- | ---
roomId | num | 房间号 | 必要 |
page | num | 返回结果页数 | 必要 |
pageSize | num | 返回结果页大小 | 必要 | 最大50
ruid | num | 主播uid | 必要 |

json 回复：

根对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
code | num | 返回值 |
message | str | 错误信息 |
ttl | num | 1 |
data | obj | 信息本体 |

`data`中的对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
onlineNum | num | 在线观众数量 |
OnlineRankItem | array | 结果 |

`OnlineRankItem`数组中的对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
userRank | num | 贡献值排名 |
uid | num | 用户id |
name | str | 用户名字 |
face | str | 用户头像 |
score | num | 贡献值 |
medalInfo | obj | 粉丝牌对象 |
guard_level | num | 大航海类型 |
wealth_level | num | 荣耀等级 |
guard_level | num | 大航海类型 |
uinfo | obj | 用户详细信息 |

`uinfo`对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
uid | num | 用户uid |
base | obj | 用户基本信息 |
medal | obj | 用户粉丝牌 |
face | str | 用户头像 |
guard | obj | 大航海 |

`guard`对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
level | num | 大航海类型 |
expired_str | str | 大航海到期时间 |

示例：

查询`23174842`直播间的大航海成员

    curl  'https://api.live.bilibili.com//xlive/general-interface/v1/rank/getOnlineGoldRank?roomId=26854650&ruid=3493118494116797&page=3&pageSize=20'

查看响应示例：

    {
        "code": 0,
        "message": "0",
        "ttl": 1,
        "data": {
            "onlineNum": 45,
            "OnlineRankItem": [
                {
                    "userRank": 1,
                    "uid": 36136895,
                    "name": "四月hallu",
                    "face": "https://i2.hdslb.com/bfs/face/5e5166ecc4c17d4dbc7a09dbb6bb749d9f537985.jpg",
                    "score": 3768,
                    "medalInfo": {
                        "guardLevel": 3,
                        "medalColorStart": 2951253,
                        "medalColorEnd": 10329087,
                        "medalColorBorder": 6809855,
                        "medalName": "钢板鹿",
                        "level": 29,
                        "targetId": 3493118494116797,
                        "isLight": 1
                    },
                    "guard_level": 3,
                    "wealth_level": 41,
                    "is_mystery": false,
                    "uinfo": {
                        "uid": 36136895,
                        "base": {
                            "name": "四月hallu",
                            "face": "https://i2.hdslb.com/bfs/face/5e5166ecc4c17d4dbc7a09dbb6bb749d9f537985.jpg",
                            "name_color": 0,
                            "is_mystery": false,
                            "risk_ctrl_info": {
                                "name": "四月hallu",
                                "face": "https://i2.hdslb.com/bfs/face/5e5166ecc4c17d4dbc7a09dbb6bb749d9f537985.jpg"
                            },
                            "origin_info": {
                                "name": "四月hallu",
                                "face": "https://i2.hdslb.com/bfs/face/5e5166ecc4c17d4dbc7a09dbb6bb749d9f537985.jpg"
                            },
                            "official_info": {
                                "role": 0,
                                "title": "",
                                "desc": "",
                                "type": -1
                            },
                            "name_color_str": ""
                        },
                        "medal": {
                            "name": "钢板鹿",
                            "level": 29,
                            "color_start": 2951253,
                            "color_end": 10329087,
                            "color_border": 6809855,
                            "color": 2951253,
                            "id": 0,
                            "typ": 0,
                            "is_light": 1,
                            "ruid": 3493118494116797,
                            "guard_level": 3,
                            "score": 50422604,
                            "guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
                            "honor_icon": "",
                            "v2_medal_color_start": "#9660E5CC",
                            "v2_medal_color_end": "#9660E5CC",
                            "v2_medal_color_border": "#D47AFFFF",
                            "v2_medal_color_text": "#FFFFFFFF",
                            "v2_medal_color_level": "#6C00A099",
                            "user_receive_count": 0
                        },
                        "wealth": {
                            "level": 41,
                            "dm_icon_key": "ChronosWealth_4.png"
                        },
                        "title": null,
                        "guard": {
                            "level": 3,
                            "expired_str": "2025-07-07 23:59:59"
                        },
                        "uhead_frame": null,
                        "guard_leader": null
                    }
                },
                {
                    "userRank": 2,
                    "uid": 1182882611,
                    "name": "重生指令",
                    "face": "https://i2.hdslb.com/bfs/face/6762c39b424e6de5bf0292fd12a019201a501fb9.jpg",
                    "score": 1546,
                    "medalInfo": {
                        "guardLevel": 0,
                        "medalColorStart": 12632256,
                        "medalColorEnd": 12632256,
                        "medalColorBorder": 12632256,
                        "medalName": "雪狐咕",
                        "level": 24,
                        "targetId": 477792,
                        "isLight": 0
                    },
                    "guard_level": 3,
                    "wealth_level": 22,
                    "is_mystery": false,
                    "uinfo": {
                        "uid": 1182882611,
                        "base": {
                            "name": "重生指令",
                            "face": "https://i2.hdslb.com/bfs/face/6762c39b424e6de5bf0292fd12a019201a501fb9.jpg",
                            "name_color": 0,
                            "is_mystery": false,
                            "risk_ctrl_info": {
                                "name": "重生指令",
                                "face": "https://i2.hdslb.com/bfs/face/6762c39b424e6de5bf0292fd12a019201a501fb9.jpg"
                            },
                            "origin_info": {
                                "name": "重生指令",
                                "face": "https://i2.hdslb.com/bfs/face/6762c39b424e6de5bf0292fd12a019201a501fb9.jpg"
                            },
                            "official_info": {
                                "role": 0,
                                "title": "",
                                "desc": "",
                                "type": -1
                            },
                            "name_color_str": ""
                        },
                        "medal": {
                            "name": "雪狐咕",
                            "level": 24,
                            "color_start": 12632256,
                            "color_end": 12632256,
                            "color_border": 12632256,
                            "color": 1725515,
                            "id": 0,
                            "typ": 0,
                            "is_light": 0,
                            "ruid": 477792,
                            "guard_level": 0,
                            "score": 50010220,
                            "guard_icon": "",
                            "honor_icon": "",
                            "v2_medal_color_start": "#919298CC",
                            "v2_medal_color_end": "#919298CC",
                            "v2_medal_color_border": "#919298CC",
                            "v2_medal_color_text": "#FFFFFFFF",
                            "v2_medal_color_level": "#6C6C7299",
                            "user_receive_count": 0
                        },
                        "wealth": {
                            "level": 22,
                            "dm_icon_key": ""
                        },
                        "title": null,
                        "guard": {
                            "level": 3,
                            "expired_str": "2025-06-29 23:59:59"
                        },
                        "uhead_frame": null,
                        "guard_leader": null
                    }
                },
                {
                    "userRank": 3,
                    "uid": 35007043,
                    "name": "_单推哈鹿halluの狐狸",
                    "face": "https://i1.hdslb.com/bfs/face/6373a98189480661fc725494ab5ab68253522b8f.jpg",
                    "score": 1543,
                    "medalInfo": {
                        "guardLevel": 2,
                        "medalColorStart": 2951253,
                        "medalColorEnd": 10329087,
                        "medalColorBorder": 16771156,
                        "medalName": "钢板鹿",
                        "level": 29,
                        "targetId": 3493118494116797,
                        "isLight": 1
                    },
                    "guard_level": 2,
                    "wealth_level": 40,
                    "is_mystery": false,
                    "uinfo": {
                        "uid": 35007043,
                        "base": {
                            "name": "_单推哈鹿halluの狐狸",
                            "face": "https://i1.hdslb.com/bfs/face/6373a98189480661fc725494ab5ab68253522b8f.jpg",
                            "name_color": 0,
                            "is_mystery": false,
                            "risk_ctrl_info": {
                                "name": "_单推哈鹿halluの狐狸",
                                "face": "https://i1.hdslb.com/bfs/face/6373a98189480661fc725494ab5ab68253522b8f.jpg"
                            },
                            "origin_info": {
                                "name": "_单推哈鹿halluの狐狸",
                                "face": "https://i1.hdslb.com/bfs/face/6373a98189480661fc725494ab5ab68253522b8f.jpg"
                            },
                            "official_info": {
                                "role": 0,
                                "title": "",
                                "desc": "",
                                "type": -1
                            },
                            "name_color_str": ""
                        },
                        "medal": {
                            "name": "钢板鹿",
                            "level": 29,
                            "color_start": 2951253,
                            "color_end": 10329087,
                            "color_border": 16771156,
                            "color": 2951253,
                            "id": 0,
                            "typ": 0,
                            "is_light": 1,
                            "ruid": 3493118494116797,
                            "guard_level": 2,
                            "score": 50360413,
                            "guard_icon": "https://i0.hdslb.com/bfs/live/98a201c14a64e860a758f089144dcf3f42e7038c.png",
                            "honor_icon": "",
                            "v2_medal_color_start": "#9660E5CC",
                            "v2_medal_color_end": "#9660E5CC",
                            "v2_medal_color_border": "#D47AFFFF",
                            "v2_medal_color_text": "#FFFFFFFF",
                            "v2_medal_color_level": "#6C00A099",
                            "user_receive_count": 0
                        },
                        "wealth": {
                            "level": 40,
                            "dm_icon_key": "ChronosWealth_4.png"
                        },
                        "title": null,
                        "guard": {
                            "level": 2,
                            "expired_str": "2025-07-30 23:59:59"
                        },
                        "uhead_frame": null,
                        "guard_leader": null
                    }
                },
                {
                    "userRank": 7,
                    "uid": 44152084,
                    "name": "_柚_子_hallu",
                    "face": "https://i1.hdslb.com/bfs/face/137498c2c6a3231e5b6047af12a64bbd19627dcb.jpg",
                    "score": 324,
                    "medalInfo": {
                        "guardLevel": 3,
                        "medalColorStart": 398668,
                        "medalColorEnd": 6850801,
                        "medalColorBorder": 6809855,
                        "medalName": "钢板鹿",
                        "level": 26,
                        "targetId": 3493118494116797,
                        "isLight": 1
                    },
                    "guard_level": 3,
                    "wealth_level": 32,
                    "is_mystery": false,
                    "uinfo": {
                        "uid": 44152084,
                        "base": {
                            "name": "_柚_子_hallu",
                            "face": "https://i1.hdslb.com/bfs/face/137498c2c6a3231e5b6047af12a64bbd19627dcb.jpg",
                            "name_color": 0,
                            "is_mystery": false,
                            "risk_ctrl_info": {
                                "name": "_柚_子_hallu",
                                "face": "https://i1.hdslb.com/bfs/face/137498c2c6a3231e5b6047af12a64bbd19627dcb.jpg"
                            },
                            "origin_info": {
                                "name": "_柚_子_hallu",
                                "face": "https://i1.hdslb.com/bfs/face/137498c2c6a3231e5b6047af12a64bbd19627dcb.jpg"
                            },
                            "official_info": {
                                "role": 0,
                                "title": "",
                                "desc": "",
                                "type": -1
                            },
                            "name_color_str": ""
                        },
                        "medal": {
                            "name": "钢板鹿",
                            "level": 26,
                            "color_start": 398668,
                            "color_end": 6850801,
                            "color_border": 6809855,
                            "color": 398668,
                            "id": 0,
                            "typ": 0,
                            "is_light": 1,
                            "ruid": 3493118494116797,
                            "guard_level": 3,
                            "score": 50057285,
                            "guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
                            "honor_icon": "",
                            "v2_medal_color_start": "#4775EFCC",
                            "v2_medal_color_end": "#4775EFCC",
                            "v2_medal_color_border": "#58A1F8FF",
                            "v2_medal_color_text": "#FFFFFFFF",
                            "v2_medal_color_level": "#000B7099",
                            "user_receive_count": 0
                        },
                        "wealth": {
                            "level": 32,
                            "dm_icon_key": ""
                        },
                        "title": null,
                        "guard": {
                            "level": 3,
                            "expired_str": "2025-06-27 23:59:59"
                        },
                        "uhead_frame": null,
                        "guard_leader": null
                    }
                },
                {
                    "userRank": 8,
                    "uid": 8242366,
                    "name": "翟赧hallu",
                    "face": "https://i1.hdslb.com/bfs/face/9b312f4146ca2c8a1d2e5468e345ecfb60be3874.jpg",
                    "score": 276,
                    "medalInfo": {
                        "guardLevel": 3,
                        "medalColorStart": 398668,
                        "medalColorEnd": 6850801,
                        "medalColorBorder": 6809855,
                        "medalName": "钢板鹿",
                        "level": 28,
                        "targetId": 3493118494116797,
                        "isLight": 1
                    },
                    "guard_level": 3,
                    "wealth_level": 35,
                    "is_mystery": false,
                    "uinfo": {
                        "uid": 8242366,
                        "base": {
                            "name": "翟赧hallu",
                            "face": "https://i1.hdslb.com/bfs/face/9b312f4146ca2c8a1d2e5468e345ecfb60be3874.jpg",
                            "name_color": 0,
                            "is_mystery": false,
                            "risk_ctrl_info": {
                                "name": "翟赧hallu",
                                "face": "https://i1.hdslb.com/bfs/face/9b312f4146ca2c8a1d2e5468e345ecfb60be3874.jpg"
                            },
                            "origin_info": {
                                "name": "翟赧hallu",
                                "face": "https://i1.hdslb.com/bfs/face/9b312f4146ca2c8a1d2e5468e345ecfb60be3874.jpg"
                            },
                            "official_info": {
                                "role": 0,
                                "title": "",
                                "desc": "",
                                "type": -1
                            },
                            "name_color_str": ""
                        },
                        "medal": {
                            "name": "钢板鹿",
                            "level": 28,
                            "color_start": 398668,
                            "color_end": 6850801,
                            "color_border": 6809855,
                            "color": 398668,
                            "id": 0,
                            "typ": 0,
                            "is_light": 1,
                            "ruid": 3493118494116797,
                            "guard_level": 3,
                            "score": 50208414,
                            "guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
                            "honor_icon": "",
                            "v2_medal_color_start": "#4775EFCC",
                            "v2_medal_color_end": "#4775EFCC",
                            "v2_medal_color_border": "#58A1F8FF",
                            "v2_medal_color_text": "#FFFFFFFF",
                            "v2_medal_color_level": "#000B7099",
                            "user_receive_count": 0
                        },
                        "wealth": {
                            "level": 35,
                            "dm_icon_key": ""
                        },
                        "title": null,
                        "guard": {
                            "level": 3,
                            "expired_str": "2025-08-05 23:59:59"
                        },
                        "uhead_frame": null,
                        "guard_leader": null
                    }
                },
                {
                    "userRank": 9,
                    "uid": 418232,
                    "name": "lug7",
                    "face": "http://i2.hdslb.com/bfs/face/5d2c92beb774a4bb30762538bb102d23670ae9c0.gif",
                    "score": 171,
                    "medalInfo": {
                        "guardLevel": 3,
                        "medalColorStart": 398668,
                        "medalColorEnd": 6850801,
                        "medalColorBorder": 6809855,
                        "medalName": "钢板鹿",
                        "level": 26,
                        "targetId": 3493118494116797,
                        "isLight": 1
                    },
                    "guard_level": 3,
                    "wealth_level": 28,
                    "is_mystery": false,
                    "uinfo": {
                        "uid": 418232,
                        "base": {
                            "name": "lug7",
                            "face": "http://i2.hdslb.com/bfs/face/5d2c92beb774a4bb30762538bb102d23670ae9c0.gif",
                            "name_color": 0,
                            "is_mystery": false,
                            "risk_ctrl_info": {
                                "name": "lug7",
                                "face": "http://i2.hdslb.com/bfs/face/5d2c92beb774a4bb30762538bb102d23670ae9c0.gif"
                            },
                            "origin_info": {
                                "name": "lug7",
                                "face": "http://i2.hdslb.com/bfs/face/5d2c92beb774a4bb30762538bb102d23670ae9c0.gif"
                            },
                            "official_info": {
                                "role": 0,
                                "title": "",
                                "desc": "",
                                "type": -1
                            },
                            "name_color_str": ""
                        },
                        "medal": {
                            "name": "钢板鹿",
                            "level": 26,
                            "color_start": 398668,
                            "color_end": 6850801,
                            "color_border": 6809855,
                            "color": 398668,
                            "id": 0,
                            "typ": 0,
                            "is_light": 1,
                            "ruid": 3493118494116797,
                            "guard_level": 3,
                            "score": 50050050,
                            "guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
                            "honor_icon": "",
                            "v2_medal_color_start": "#4775EFCC",
                            "v2_medal_color_end": "#4775EFCC",
                            "v2_medal_color_border": "#58A1F8FF",
                            "v2_medal_color_text": "#FFFFFFFF",
                            "v2_medal_color_level": "#000B7099",
                            "user_receive_count": 0
                        },
                        "wealth": {
                            "level": 28,
                            "dm_icon_key": ""
                        },
                        "title": null,
                        "guard": {
                            "level": 3,
                            "expired_str": "2025-06-15 23:59:59"
                        },
                        "uhead_frame": null,
                        "guard_leader": null
                    }
                },
                {
                    "userRank": 10,
                    "uid": 452228643,
                    "name": "很糊的小龔鬱hallu",
                    "face": "https://i0.hdslb.com/bfs/face/996fa85fe42d582dd013dcb435de3f3ff4d33f6c.jpg",
                    "score": 35,
                    "medalInfo": {
                        "guardLevel": 0,
                        "medalColorStart": 6126494,
                        "medalColorEnd": 6126494,
                        "medalColorBorder": 6126494,
                        "medalName": "牧斯",
                        "level": 6,
                        "targetId": 3493087074585126,
                        "isLight": 1
                    },
                    "guard_level": 3,
                    "wealth_level": 35,
                    "is_mystery": false,
                    "uinfo": {
                        "uid": 452228643,
                        "base": {
                            "name": "很糊的小龔鬱hallu",
                            "face": "https://i0.hdslb.com/bfs/face/996fa85fe42d582dd013dcb435de3f3ff4d33f6c.jpg",
                            "name_color": 0,
                            "is_mystery": false,
                            "risk_ctrl_info": {
                                "name": "很糊的小龔鬱hallu",
                                "face": "https://i0.hdslb.com/bfs/face/996fa85fe42d582dd013dcb435de3f3ff4d33f6c.jpg"
                            },
                            "origin_info": {
                                "name": "很糊的小龔鬱hallu",
                                "face": "https://i0.hdslb.com/bfs/face/996fa85fe42d582dd013dcb435de3f3ff4d33f6c.jpg"
                            },
                            "official_info": {
                                "role": 0,
                                "title": "",
                                "desc": "",
                                "type": -1
                            },
                            "name_color_str": ""
                        },
                        "medal": {
                            "name": "牧斯",
                            "level": 6,
                            "color_start": 6126494,
                            "color_end": 6126494,
                            "color_border": 6126494,
                            "color": 6126494,
                            "id": 0,
                            "typ": 0,
                            "is_light": 1,
                            "ruid": 3493087074585126,
                            "guard_level": 0,
                            "score": 3400,
                            "guard_icon": "",
                            "honor_icon": "",
                            "v2_medal_color_start": "#5866C799",
                            "v2_medal_color_end": "#5866C799",
                            "v2_medal_color_border": "#5866C799",
                            "v2_medal_color_text": "#FFFFFFFF",
                            "v2_medal_color_level": "#000B7099",
                            "user_receive_count": 0
                        },
                        "wealth": {
                            "level": 35,
                            "dm_icon_key": ""
                        },
                        "title": null,
                        "guard": {
                            "level": 3,
                            "expired_str": "2025-06-19 23:59:59"
                        },
                        "uhead_frame": null,
                        "guard_leader": null
                    }
                },
                {
                    "userRank": 11,
                    "uid": 164871173,
                    "name": "奶浴-bllss",
                    "face": "https://i2.hdslb.com/bfs/face/f48dd7c1e432eb91e5fd286757c4e2600930f4c5.jpg",
                    "score": 26,
                    "medalInfo": null,
                    "guard_level": 3,
                    "wealth_level": 36,
                    "is_mystery": false,
                    "uinfo": {
                        "uid": 164871173,
                        "base": {
                            "name": "奶浴-bllss",
                            "face": "https://i2.hdslb.com/bfs/face/f48dd7c1e432eb91e5fd286757c4e2600930f4c5.jpg",
                            "name_color": 0,
                            "is_mystery": false,
                            "risk_ctrl_info": {
                                "name": "奶浴-bllss",
                                "face": "https://i2.hdslb.com/bfs/face/f48dd7c1e432eb91e5fd286757c4e2600930f4c5.jpg"
                            },
                            "origin_info": {
                                "name": "奶浴-bllss",
                                "face": "https://i2.hdslb.com/bfs/face/f48dd7c1e432eb91e5fd286757c4e2600930f4c5.jpg"
                            },
                            "official_info": {
                                "role": 0,
                                "title": "",
                                "desc": "",
                                "type": -1
                            },
                            "name_color_str": ""
                        },
                        "medal": null,
                        "wealth": {
                            "level": 36,
                            "dm_icon_key": ""
                        },
                        "title": null,
                        "guard": {
                            "level": 3,
                            "expired_str": "2025-07-20 23:59:59"
                        },
                        "uhead_frame": null,
                        "guard_leader": null
                    }
                },
            ],
            "ownInfo": {
                "uid": 0,
                "name": "",
                "face": "",
                "rank": -1,
                "needScore": 0,
                "score": 0,
                "guard_level": 0,
                "wealth_level": 0,
                "is_mystery": false,
                "uinfo": null
            },
            "tips_text": "投喂、点赞、发弹幕、持续观看均可上榜",
            "value_text": "贡献值",
            "ab": {
                "guard_accompany_list": 1
            },
            "onlineNumText": "45"
        }
    }

## 查询自己在某直播间观看时长

> https://api.live.bilibili.com/xlive/general-interface/v1/guard/GuardActive

请求方式：GET

认证方式：Cookie（SESSDATA）或 APP

url 参数：

参数名 | 类型 | 内容 | 必要性 | 备注
--- | --- | --- | --- | ---
platform | str | android | 必要 |
ruid | num | 主播uid | 必要 |

json 回复：

根对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
code | num | 返回值 |
message | str | 错误信息 |
ttl | num | 1 |
data | obj | 信息本体 |

`data`中的对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
ruid | num | 主播uid |
rusername | str | 主播用户名 |
rface | str | 主播头像 |
username | str | 自己的用户名 |
accomany | int | 大航海陪伴天数 | 似乎b站程序员把这个单词拼错了
rusername | str | 主播用户名 |
watch_time | num | 观看时长 | 单位是秒
up_medal | obj | 粉丝牌 |
guard_num_3 | num | 主播舰长数量 |
guard_num_2 | num | 主播提督数量 |
guard_num_1 | num | 主播总督数量 |
is_live | num | 直播状态 |

## 查询用户在直播间的信息

> https://api.live.bilibili.com/xlive/app-ucenter/v2/card/user

请求方式：GET

认证方式：无

url 参数：

参数名 | 类型 | 内容 | 必要性 | 备注
--- | --- | --- | --- | ---
uid | num | 目标用户uid | 必要 |
ruid | num | 主播uid | 必要 |

json 回复：

根对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
code | num | 返回值 |
message | str | 错误信息 |
ttl | num | 1 |
data | obj | 信息本体 |

`data`对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
uid | num | 目标用户id |
uname | str | 目标用户名 |
desc | str | 目标用户认证信息 |
face | str | 目标用户头像 |
follow_num | num | 目标用户粉丝数 |
attention_num | num | 目标用户关注数 |
main_vip | num | 目标用户大会员状态 | 0：无 2：大会员
is_block | num | 是否被拉黑？ | 始终为0？
is_admin | num | 是否房管 |
is_black | num | 是否被关小黑屋 |
wealth_info | obj | 荣耀等级 |
fans_medal | obj | 粉丝牌 | 如果目标用户隐藏粉丝牌则为null

`wealth_info`对象：

字段 | 类型 | 内容 | 备注
--- | --- | --- | ---
level | num | 荣耀等级 |
level_total_score | num | 下一等级的荣耀值 |
cur_score | num | 当前荣耀值 |
upgrade_need_score | num | 升到下一等级还差多少荣耀值 |

示例：

    curl  'https://api.live.bilibili.com/xlive/app-ucenter/v2/card/user?ruid=504140200&uid=504140200'

查看响应示例：

    {
    	"code": 0,
    	"message": "0",
    	"ttl": 1,
    	"data": {
    		"uid": 504140200,
    		"uname": "软软riu",
    		"face": "https://i1.hdslb.com/bfs/face/2d083d686b704eb7010e3d94595d47f5a89c8aef.jpg",
    		"verify_type": 0,
    		"desc": "bilibili UP主认证：bilibili 知名虚拟UP主、直播高能主播",
    		"uname_color": 2171169,
    		"room_id": 23174842,
    		"pendant": "https://i1.hdslb.com/bfs/garb/open/8806f97581082d68edcf2207368290b3fb3491bb.png",
    		"pendant_from": 2,
    		"follow_num": 214882,
    		"attention_num": 202,
    		"relation_status": 1,
    		"privilege_type": 3,
    		"fans_medal": null,
    		"title_sum": 10,
    		"wearing_title": "",
    		"main_vip": 0,
    		"is_block": 0,
    		"is_admin": 0,
    		"fans_medal_list_url": "https://live.bilibili.com/p/html/live-fansmedal-wall/index.html?tId=504140200#/medal",
    		"wearing": {},
    		"is_black": 0,
    		"admin_level": 0,
    		"head_picture": "http://i0.hdslb.com/bfs/live/3f536f59e337a731c5367f623bca79b32197ddd5.png",
    		"head_text": "大航海舰长",
    		"head_url": "",
    		"head_business": 1,
    		"head_skin_icon": "http://i0.hdslb.com/bfs/live/d44e103f424f5ae01ef3d0133ef812f8241d15b0.png",
    		"privilege_center": {},
    		"is_nft": 0,
    		"nft_dmark": "https://i0.hdslb.com/bfs/live/9f176ff49d28c50e9c53ec1c3297bd1ee539b3d6.gif",
    		"is_real_fans": false,
    		"wealth_info": {
    			"uid": 504140200,
    			"level": 35,
    			"level_total_score": 6000000,
    			"cur_score": 5012900,
    			"upgrade_need_score": 987100,
    			"status": 1,
    			"dm_icon_key": ""
    		},
    		"guard": {
    			"accompany": 0,
    			"accompany_slake": 0
    		},
    		"chat_url_android": "activity://im/conversation/?conversation_type=1&reciveid=504140200",
    		"chat_url_ios": "bilibili://link/chat?session_id=s504140200",
    		"gift_star": null,
    		"is_mystery": false,
    		"text_control": null,
    		"uinfo_medal": null,
    		"guard_attire": {},
    		"flash_buy": 0,
    		"flash_buy_url": ""
    	}
    }