admin/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

添加部分直播相关api (#1297)

Browse Source 
* 添加部分直播相关api

* 添加部分直播相关接口

* 添加部分直播相关api
This commit is contained in:
114514ns
2025-06-22 02:28:52 +08:00
committed by GitHub
parent 34f5c70174
commit 2f48f6c81a
9 changed files with 2885 additions and 614 deletions
Download Patch File Download Diff File Expand all files Collapse all files

191
docs/live/gift.md Normal file
View File

@@ -0,0 +1,191 @@
## 获取直播间内礼物
> https://api.live.bilibili.com/xlive/web-room/v1/giftPanel/roomGiftList
*请求方式：GET*
认证方式：无 (无需添加Cookie)
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------------- | ---- | ---------- | ------ | -------------------------------- |
| platform | str | web | 必要 | |
| room_id | num | 主播房间号 | 必要 | |
| area_parent_id | num | 直播分区 | 非必要 | 不填写可能会获取不到部分活动礼物 |
| area_id | num | 直播子分区 | 非必要 | 不填写可能会获取不到部分活动礼物 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | |
| data | obj | 信息本体 | |
`data.gift_config.base_config.list` 数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------------- | ---- | ------------------- | --------------------------- |
| id | num | 礼物id | |
| name | str | 礼物名字 | |
| price | num | 该值/1000的单位为元 | |
| type | num | | |
| coin_type | str | 一般为gold，即电池 | |
| effect | num | 特效类型？ | 观察到可能出现的值为0，2，3 |
| stay_time | num | 礼物展示的时间？ | 均为3 |
| animation_frame_num | num | 礼物动画帧数 | |
| desc | str | 礼物描述 | |
| img_basic | str | 礼物图片 | |
| gif | str | 礼物gif动画 | |
**示例：**
查询`room_id=23375552`的直播间礼物信息
```shell
curl 'https://api.live.bilibili.com/xlive/web-room/v1/giftPanel/roomGiftList?platform=pc&room_id=23174842'
```
## 获取盲盒概率
> https://api.live.bilibili.com/xlive/general-interface/v1/blindFirstWin/getInfo
*请求方式：GET*
认证方式：无 (无需添加Cookie)
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ---- | ---------------- | ---- |
| gift_id | num | | 盲盒对应的礼物id | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | |
| data | obj | 信息本体 | |
`data`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ----- | -------- | ---- |
| note_text | str | 描述 | |
| blind_price | num | 盲盒价格 | |
| blind_gift_name | str | 盲盒名字 | |
| gifts | array | 盲盒价格 | |
`gifts数组`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | -------------- | ---- |
| gift_id | num | 爆出的礼物id | |
| price | num | 爆出的礼物价格 | |
| gift_name | str | 礼物名字 | |
| gift_img | str | 礼物图片 | |
| chance | str | 概率 | |
**示例：**
查询`心动盲盒`的概率
```shell
curl 'https://api.live.bilibili.com/xlive/general-interface/v1/blindFirstWin/getInfo?gift_id=32251'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"note_text": "每日1次机会，首次投喂盲盒时享首抽福利！",
"blind_price": 15000,
"gifts": [
{
"gift_id": 32125,
"price": 2000,
"gift_name": "电影票",
"gift_img": "https://s1.hdslb.com/bfs/live/20864a10beaea541c7dce264d5bbc56676d63e4f.png",
"is_win_gift": 0,
"chance": "6%"
},
{
"gift_id": 32126,
"price": 9000,
"gift_name": "棉花糖",
"gift_img": "https://s1.hdslb.com/bfs/live/b555682af41551c28f8ad19dc5c4ed87943c84f4.png",
"is_win_gift": 0,
"chance": "44.5%"
},
{
"gift_id": 32128,
"price": 16000,
"gift_name": "爱心抱枕",
"gift_img": "https://s1.hdslb.com/bfs/live/824714c830966d7bec381e35ef808b1f478e21ee.png",
"is_win_gift": 1,
"chance": "45.56%"
},
{
"gift_id": 32281,
"price": 40000,
"gift_name": "绮彩权杖",
"gift_img": "https://s1.hdslb.com/bfs/live/5cecbf274a4205ef76ed3f11c6540f0c6743363c.png",
"is_win_gift": 1,
"chance": "3.7%"
},
{
"gift_id": 32282,
"price": 100000,
"gift_name": "时空之站",
"gift_img": "https://s1.hdslb.com/bfs/live/9ee53aedda3c891fdf23d35c14b3bdc4e0504a97.png",
"is_win_gift": 1,
"chance": "0.12%"
},
{
"gift_id": 34894,
"price": 200000,
"gift_name": "蛇形护符",
"gift_img": "https://s1.hdslb.com/bfs/live/2127dd998083a8981ef4e31a4e6787ce5a4d0f9f.png",
"is_win_gift": 1,
"chance": "0.08%"
},
{
"gift_id": 32132,
"price": 2233000,
"gift_name": "浪漫城堡",
"gift_img": "https://s1.hdslb.com/bfs/live/216fac597b3c5619d56ed332bcf5f880ea657e8e.png",
"is_win_gift": 1,
"chance": "0.04%"
}
],
"friday_yq_id": 106472,
"is_first": true,
"ab_res": 1,
"uid": 451537183,
"conf_id": 51,
"pre_imgs": [
{
"gift_id": 32132,
"preview_url": "http://i0.hdslb.com/bfs/live/e40708d0c8ef9505027ac33ad2a17a23e8e01139.mp4"
}
],
"blind_gift_name": "心动盲盒"
}
}
```
</details>

592
docs/live/guard.md Normal file
View File

@@ -0,0 +1,592 @@
## 查询大航海成员
> https://api.live.bilibili.com/xlive/app-room/v2/guardTab/topListNew
*请求方式: GET*
认证方式：无（无需Cookie）
**URL参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | -------- | ------ | --------------------------------------- |
| roomid | num | 直播间号 | 必要 | |
| page | num | 页数 | 必要 | |
| ruid | num | 主播id | 必要 | |
| page_size | num | 页大小 | 非必要 | 默认20，最大30，若超过则作为10处理 |
| typ | num | 排序方式 | 非必要 | typ=3,4,5分别为按周/月/总航海亲密度排序 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ----- | -------------- | --------------------------------------- |
| info | obj | 主播mid | |
| top3 | array | 整个列表的top3 |
| list | array | 大航海成员 | page=1时，list[0]得到的会是榜单的第四名 |
`list`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ---- | -------- | ----- |
| ruid | num | 主播UID | |
| rank | num | 榜单排名 | |
| accompany | num | 陪伴天数 | |
| uinfo | obj | 用户信息 | |
| score | num | 亲密度 | 恒为0 |
`list`对象的`uinfo`：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------ | -------------------------------------------------------- |
| uid | num | 用户UID | |
| base | obj | 用户基本信息 | |
| medal | obj | 粉丝牌 | 与[此处](/bilibili-API-collect/docs/user/medals)基本一致 |
`list`对象的`uinfo`的`base`：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ------ | -------- | ---- |
| name | string | 用户名 | |
| face | string | 用戶头像 | |
**示例：**
查询`23174842`直播间的大航海成员
```shell
curl ' https://api.live.bilibili.com/xlive/app-room/v2/guardTab/topListNew?ruid=504140200&roomid=23174842&page=1'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"info": {
"num": 23,
"page": 10,
"now": 1,
"achievement_level": 1,
"anchor_guard_achieve_level": 0,
"achievement_icon_src": "",
"buy_guard_icon_src": "https://i0.hdslb.com/bfs/live/4a481b491767f9d91165a4631252de4503d63a17.png",
"rule_doc_src": "",
"ex_background_src": "https://i0.hdslb.com/bfs/live/d0e938839a9dee733e8a7f9f6a3a132108ae22bc.png",
"color_start": "",
"color_end": "",
"tab_color": [
"#4DDDDBD5",
"#26CFCBC0"
],
"title_color": [
"#FFC9CCD0",
"#FF9499A0"
]
},
"list": [
{
"ruid": 504140200,
"rank": 4,
"accompany": 36,
"uinfo": {
"uid": 432911315,
"base": {
"name": "幻想乡的年华",
"face": "https://i2.hdslb.com/bfs/face/5ddde7a8466aa2d60d082ccfc08a0267445b193b.jpg",
"name_color": 0,
"is_mystery": false,
"risk_ctrl_info": null,
"origin_info": {
"name": "幻想乡的年华",
"face": "https://i2.hdslb.com/bfs/face/5ddde7a8466aa2d60d082ccfc08a0267445b193b.jpg"
},
"official_info": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"name_color_str": ""
},
"medal": {
"name": "软饭兔",
"level": 25,
"color_start": 398668,
"color_end": 6850801,
"color_border": 16771156,
"color": 398668,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 2,
"score": 0,
"guard_icon": "",
"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": null,
"title": null,
"guard": {
"level": 2,
"expired_str": ""
},
"uhead_frame": null,
"guard_leader": null
},
"score": 0
},
{
"ruid": 504140200,
"rank": 5,
"accompany": 513,
"uinfo": {
"uid": 7816639,
"base": {
"name": "在这样的时光",
"face": "https://i1.hdslb.com/bfs/face/3b0091dda76e095351907e9c708b9571716aa3e1.jpg",
"name_color": 0,
"is_mystery": false,
"risk_ctrl_info": null,
"origin_info": {
"name": "在这样的时光",
"face": "https://i1.hdslb.com/bfs/face/3b0091dda76e095351907e9c708b9571716aa3e1.jpg"
},
"official_info": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"name_color_str": ""
},
"medal": {
"name": "软饭兔",
"level": 30,
"color_start": 2951253,
"color_end": 10329087,
"color_border": 6809855,
"color": 2951253,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 3,
"score": 0,
"guard_icon": "",
"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": null,
"title": null,
"guard": {
"level": 3,
"expired_str": ""
},
"uhead_frame": null,
"guard_leader": null
},
"score": 0
}
],
"top3": [
{
"ruid": 504140200,
"rank": 1,
"accompany": 306,
"uinfo": {
"uid": 85743027,
"base": {
"name": "-小fa---",
"face": "https://i0.hdslb.com/bfs/face/82b2d0fef27b7b69be0d121b3ef0491504bbaae8.jpg",
"name_color": 0,
"is_mystery": false,
"risk_ctrl_info": null,
"origin_info": {
"name": "-小fa---",
"face": "https://i0.hdslb.com/bfs/face/82b2d0fef27b7b69be0d121b3ef0491504bbaae8.jpg"
},
"official_info": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"name_color_str": ""
},
"medal": {
"name": "软饭兔",
"level": 30,
"color_start": 2951253,
"color_end": 10329087,
"color_border": 16771156,
"color": 2951253,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 2,
"score": 0,
"guard_icon": "",
"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": null,
"title": null,
"guard": {
"level": 2,
"expired_str": ""
},
"uhead_frame": null,
"guard_leader": null
},
"score": 0
},
{
"ruid": 504140200,
"rank": 2,
"accompany": 1005,
"uinfo": {
"uid": 28601039,
"base": {
"name": "捏软软的上帝",
"face": "https://i2.hdslb.com/bfs/face/1f2a9b20294452d5c6ce9f40c66b186ef57b92e5.jpg",
"name_color": 0,
"is_mystery": false,
"risk_ctrl_info": null,
"origin_info": {
"name": "捏软软的上帝",
"face": "https://i2.hdslb.com/bfs/face/1f2a9b20294452d5c6ce9f40c66b186ef57b92e5.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": 504140200,
"guard_level": 2,
"score": 0,
"guard_icon": "",
"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": null,
"title": null,
"guard": {
"level": 2,
"expired_str": ""
},
"uhead_frame": null,
"guard_leader": null
},
"score": 0
},
{
"ruid": 504140200,
"rank": 3,
"accompany": 95,
"uinfo": {
"uid": 3546834244995088,
"base": {
"name": "老实逸流-恩师软软riu",
"face": "https://i1.hdslb.com/bfs/face/0b1f95d926acfb06c8d7d9c66d2e1fabf3e1a3c4.jpg",
"name_color": 0,
"is_mystery": false,
"risk_ctrl_info": null,
"origin_info": {
"name": "老实逸流-恩师软软riu",
"face": "https://i1.hdslb.com/bfs/face/0b1f95d926acfb06c8d7d9c66d2e1fabf3e1a3c4.jpg"
},
"official_info": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"name_color_str": ""
},
"medal": {
"name": "软饭兔",
"level": 28,
"color_start": 398668,
"color_end": 6850801,
"color_border": 16771156,
"color": 398668,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 2,
"score": 0,
"guard_icon": "",
"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": null,
"title": null,
"guard": {
"level": 2,
"expired_str": ""
},
"uhead_frame": null,
"guard_leader": null
},
"score": 0
}
],
"my_follow_info": {
"accompany_days": 0,
"auto_renew": 0,
"renew_remind": {
"content": "",
"type": 0,
"hint": ""
},
"rank": 0,
"ruid": 0,
"uinfo": null,
"expired_time": ""
},
"guard_warn": {
"is_warn": 0,
"warn": "",
"expired": 0,
"will_expired": 0,
"address": ""
},
"exist_benefit": false,
"remind_benefit": "立即上船",
"ab": {
"guard_accompany_list": 1
},
"remind_msg": "头号粉丝大航海，上船后可上榜",
"typ": 0,
"extop": null,
"guard_leader": null,
"main_text": "",
"sub_text": "",
"btn_type": 1,
"prompt_text": "头号粉丝大航海，等你来上船"
}
}
```
</details>
## 查询粉丝团成员
> https://api.live.bilibili.com/xlive/general-interface/v1/rank/getFansMembersRank
*请求方式: GET*
认证方式：无（无需Cookie）
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | -------------- | ------------------- | ----------------------------------------------------------------------------------------------- |
| page | num | 页数 | 必要 | |
| ruid | num | 主播id | 必要 | |
| page_size | num | 每页返回的数量 | 必要 | 最大30，若超过则作为10处理 |
| rank_type | num | 排序方式 | 非必要 | 1：按照粉丝牌还亮着的粉丝团成员的亲密度排序<br> 2：按照**所有**没上过舰的粉丝团成员的亲密度排序 |
| ts | num | 13位时间戳 | 当rank_type=2时必要 | 该值>=1000即可 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | -------------- | ---- |
| item | array | 内容 | |
| num | num | 粉丝团成员数量 |
| medal_status | num | |
`list`对象
| 字段 | 类型 | 内容 | 备注 |
| ------------------ | ---- | ---------------------------------------------------------------- | ---- |
| user_rank | num | 排名 |
| uid | num | 用户UID |
| name | str | 用户名 |
| face | str | 用户头像 |
| score | num | 亲密度 |
| medal_name | str | 粉丝牌名字 |
| level | num | 粉丝牌等级 |
| target_id | num | 主播UID |
| guard_level | num | 大航海类型，1，2，3分别为总督，提督，舰长 |
| medal_color_start | num | 粉丝牌渐变起始色 |
| medal_color_end | num | 粉丝牌渐变结束色 |
| medal_color_border | num | 粉丝牌边框颜色 |
| guard_icon | str | 大航海图标URL |
| uinfo_medal | obj | 粉丝牌，与[此处](/bilibili-API-collect/docs/user/medals)基本一致 |
**示例：**
查询用户`504140200`的粉丝团成员
```shell
curl 'https://api.live.bilibili.com/xlive/general-interface/v1/rank/getFansMembersRank?ruid=504140200&page_size=10&page=1'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"item": [
{
"user_rank": 1,
"uid": 85743027,
"name": "小软兔のfa",
"face": "https://i0.hdslb.com/bfs/face/bdbcabf8d927844ae4f8f9c65862077e29afb989.jpg",
"score": 50990540,
"medal_name": "软饭兔",
"level": 30,
"target_id": 504140200,
"special": "",
"guard_level": 3,
"medal_color_start": 2951253,
"medal_color_end": 10329087,
"medal_color_border": 6809855,
"guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
"honor_icon": "",
"uinfo_medal": {
"name": "软饭兔",
"level": 30,
"color_start": 2951253,
"color_end": 10329087,
"color_border": 6809855,
"color": 0,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 3,
"score": 50990540,
"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
},
"tag": null,
"is_pokeable": false
},
{
"user_rank": 2,
"uid": 7816639,
"name": "在这样的时光",
"face": "https://i1.hdslb.com/bfs/face/3b0091dda76e095351907e9c708b9571716aa3e1.jpg",
"score": 50704568,
"medal_name": "软饭兔",
"level": 30,
"target_id": 504140200,
"special": "",
"guard_level": 3,
"medal_color_start": 2951253,
"medal_color_end": 10329087,
"medal_color_border": 6809855,
"guard_icon": "https://i0.hdslb.com/bfs/live/143f5ec3003b4080d1b5f817a9efdca46d631945.png",
"honor_icon": "",
"uinfo_medal": {
"name": "软饭兔",
"level": 30,
"color_start": 2951253,
"color_end": 10329087,
"color_border": 6809855,
"color": 0,
"id": 0,
"typ": 0,
"is_light": 1,
"ruid": 504140200,
"guard_level": 3,
"score": 50704568,
"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
},
"tag": null,
"is_pokeable": false
}
],
"num": 89,
"medal_status": 1
}
}
```
</details>

944
docs/live/user.md
View File

@@ -1,6 +1,6 @@
# 直播间用户实用 API
## 获取用户持有的粉丝勋章信息
## 获取自己持有的粉丝勋章信息
> ~~https://api.live.bilibili.com/fans_medal/v5/live_fans_medal/iApiMedal~~ (旧)
> https://api.live.bilibili.com/xlive/app-ucenter/v1/user/GetMyMedals
@@ -20,12 +20,12 @@
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-1002002：参数异常<br />-500：服务器异常 |
| message | str | 错误信息 | 默认为 "0" |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
| message | str | 错误信息 | 默认为 "0" |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -44,7 +44,7 @@
| guard_level | num | | |
| guard_medal_title | str | 加成状态 | |
| intimacy | num | 当前已得亲密度 | |
| is_lighted | num | 是否点亮 | 0：未点亮<br />1：点亮 |
| is_lighted | num | 是否点亮 | 0：未点亮<br />1：点亮 |
| level | num | 勋章等级 | |
| medal_name | str | 勋章名 | |
| medal_color_border | num | 勋章边框颜色信息 | 颜色数值为 10 进制的 16 进制值（下同） |
@@ -116,6 +116,7 @@ curl https://api.live.bilibili.com/xlive/app-ucenter/v1/user/GetMyMedals?page=1&
</details>
## 佩戴勋章
> https://api.live.bilibili.com/xlive/web-room/v1/fansMedal/wear
@@ -193,12 +194,12 @@ _请求方式：GET_
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------- |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------ |
| code | num | 返回值 | 0：成功<br />1：参数错误 |
| ttl | num | 1 | |
| message | str | 错误信息 | 默认为当日签到奖励内容 |
| data | obj | 信息本体 | 默认为空 |
| ttl | num | 1 | |
| message | str | 错误信息 | 默认为当日签到奖励内容 |
| data | obj | 信息本体 | 默认为空 |
（目前已下线）
@@ -229,29 +230,29 @@ _请求方式：GET_
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------- |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0：成功 |
| ttl | num | 1 | |
| ttl | num | 1 | |
| message | str | 错误信息 | 默认为0 |
| data | obj | 信息本体 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ----- | ---------------------------- | ---------------------- |
| text | str | 今日签到奖励信息 | 默认为空 |
| specialText | str | 连续签到奖励信息 | 默认为空 |
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ----- | ---------------------------- | ------------------------ |
| text | str | 今日签到奖励信息 | 默认为空 |
| specialText | str | 连续签到奖励信息 | 默认为空 |
| status | num | 签到状态 | 0：未签到<br />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 | 当月已签到且有特殊奖励日列表 | 默认为空 |
| allDays | num | 当月天数 | |
| curMonth | num | 当前月 | |
| curYear | num | 当前年 | |
| curDay | num | 当前日 | |
| curData | str | 当前日期（格式化） | eg: 2023-2-19 |
| hadSignDays | num | 当月已签到天数 | 默认为0 |
| newTask | num | 作用未知 | 默认为0 |
| signDaysList | array | 当月已签到日列表 | 默认为空 |
| signBonusDaysList | array | 当月已签到且有特殊奖励日列表 | 默认为空 |
<details>
<summary>查看响应示例：</summary>
@@ -308,12 +309,12 @@ _请求方式：GET_
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------- |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0：成功 |
| ttl | num | 1 | |
| ttl | num | 1 | |
| message | str | 错误信息 | 默认为0 |
| data | obj | 信息本体 | |
| data | obj | 信息本体 | |
`data`对象：
@@ -368,3 +369,880 @@ _请求方式：GET_
```
</details>
## 查询直播间贡献榜
> 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`直播间的大航海成员
```shell
curl 'https://api.live.bilibili.com//xlive/general-interface/v1/rank/getOnlineGoldRank?roomId=26854650&ruid=3493118494116797&page=3&pageSize=20'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"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"
}
}
```
</details>
## 查询自己在某直播间观看时长
> 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 | 升到下一等级还差多少荣耀值 | |
**示例：**
```shell
curl 'https://api.live.bilibili.com/xlive/app-ucenter/v2/card/user?ruid=504140200&uid=504140200'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"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": ""
}
}
```
</details>