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

feat: add details & replace spaces

Browse Source
This commit is contained in:
晨叶梦春
2025-05-03 01:39:08 +08:00
parent 9324bc6564
commit 35510b7a08
5 changed files with 1072 additions and 933 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
docs/electric/charge_list.md
View File

@@ -161,25 +161,36 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------------------ | ---------------- | | ---------- | ---- | ------------------------ | ---------------- |
| show | bool | 是否展示视频充电鸣谢名单 | | | show | bool | 是否展示视频充电鸣谢名单 | |
| state | num | 充电功能开启状态 | -1：未开通充电功能<br />1：已开通自定义充电<br />2：已开通包月、自定义充电<br />3：已开通高档、自定义充电 | | state | num | 充电功能开启状态 | -1：未开通充电功能<br />1：已开通自定义充电<br />2：已开通包月、自定义充电<br />3：已开通包月高档、自定义充电 |
| title | str | 充电按钮显示文字 | 空字符串或 `充电` 或 `充电中` | | title | str | 充电按钮显示文字 | 空字符串或 `充电` 或 `充电中` |
| jump_url | str | 跳转url | | | jump_url | str | 跳转url | |
| icon | str | 充电图标 | | | icon | str | 充电图标 | |
| high_level | obj | 高档充电信息 | | | high_level | obj | 充电专属视频信息 | |
| with_qa_id | num | 充电问答id | |
`show_info`中的`high_level`对象： `show_info`中的`high_level`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ------------------------ | ---------------- | | -------------- | ---- | ------------------------------ | ---------------- |
| privilege_type | num | | | | privilege_type | num | 解锁视频所需最低定价档位的代码 | 见[充电档位代码与定价](../electric/monthly.md#充电档位代码privilege_type与定价) |
| title | str | | | | title | str | 提示标题 | `该视频为「{充电档位名称}」专属视频` |
| sub_title | str | | | | sub_title | str | 提示子标题 | `开通「{充电档位定价}元档包月充电」即可观看` |
| show_button | bool | | | | show_button | bool | 是否显示按钮 | |
| button_text | str | | | | button_text | str | 按钮文本 | `去开通` |
| jump_url | obj | | | | jump_url | obj | 跳转url信息 | 详细信息有待补充 |
| intro | str | | | | intro | str | 充电介绍语 | |
| open | bool | | | | open | bool | （？） | |
| new | bool | | | | new | bool | （？） | |
| question_text | str | （？） | |
| qa_detail_link | str | （？） | |
`high_level`中的`jump_url`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ----------------------- | ---- |
| up_link | str | UP主包月充电购买页面url | |
| paywall_link | str | 视频试看后的提示页面url | |
| previewbar_link | str | 视频预览页面url | |
`data`中的`list`数组： `data`中的`list`数组：

236
docs/electric/monthly.md
View File

@@ -75,7 +75,7 @@
| item | array | 充电详情 | | | item | array | 充电详情 | |
| start | num | 开始充电时间 | 秒级时间戳 | | start | num | 开始充电时间 | 秒级时间戳 |
| high_level_state | num | 是否可对UP主进行高档充电 | | | high_level_state | num | 是否可对UP主进行高档充电 | |
| elec_reply_state | num | 是否可对UP主进行专属问答 | 0：否<br />1：是<br />2：（？） | | elec_reply_state | num | 是否可对UP主进行专属问答 | 0：否<br />1：是<br />2：状态未知 |
数组`list`中的对象中的`item`数组： 数组`list`中的对象中的`item`数组：
@@ -85,7 +85,6 @@
| n | obj | 充电档位(n+1) | | | n | obj | 充电档位(n+1) | |
| …… | obj | …… | …… | | …… | obj | …… | …… |
数组`item`中的对象： 数组`item`中的对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
@@ -111,13 +110,12 @@
| signed_price | num | 下次续费金额 | 单位为千分之一元人民币 | | signed_price | num | 下次续费金额 | 单位为千分之一元人民币 |
| pay_channel | num | 签约平台 | 2：微信支付<br />4：支付宝 | | pay_channel | num | 签约平台 | 2：微信支付<br />4：支付宝 |
| period | num | 下次充电天数 | | | period | num | 下次充电天数 | |
| mobile_app | num | 充电渠道 | 可为`android`等 | | mobile_app | str | 充电渠道 | 可为`android`等 |
**示例：** **示例：**
获取自己正在使用的包月充电的列表 获取自己正在使用的包月充电的列表
```shell ```shell
curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
--data-urlencode 'page=1' \ --data-urlencode 'page=1' \
@@ -231,7 +229,6 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
} }
``` ```
</details> </details>
表示自己从2022-11-23 14:10:04开始给“2233”包月充电，并且在2022-12-21 18:35:21在微信开通了连续包年充电，在2023-12-22 00:00:00的时候会自动续费36元，并继续充电366天； 表示自己从2022-11-23 14:10:04开始给“2233”包月充电，并且在2022-12-21 18:35:21在微信开通了连续包年充电，在2023-12-22 00:00:00的时候会自动续费36元，并继续充电366天；
@@ -255,8 +252,8 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
根对象： 根对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------------------------------------------- | | ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />203101：UP主未开通包月充电功能 | | code | num | 返回值 | 0：成功<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 | | message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | | | ttl | num | 1 | |
| data | obj | 信息本体 | | | data | obj | 信息本体 | |
@@ -264,10 +261,16 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
`data`对象： `data`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------- | ---- | | ------------------ | ---- | -------------------------- | ------------------------------ |
| upower_rank | obj | 充电详情 | | | upower_rank | obj | 充电详情 | |
| item | obj | 充电欢迎语 | | | item | obj | 充电欢迎语信息 | |
| user_card | obj | UP主信息 | | | user_card | obj | UP主信息 | |
| upower_level | num | UP主开通的充电等级 | 1：非高档充电<br />2：高档充电 |
| elec_reply_state | num | 是否可对UP主进行专属问答 | |
| voucher_state | obj | 包月充电券信息 | **详细信息有待补充** |
| upower_right_count | obj | 不同充电档位下的充电权益数 | |
| only_contain_medal | bool | 享有的权益仅为粉丝勋章 | |
| privilege_type | num | 当前给该UP主包月充电的档位 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价)，若从未给该UP主包月充电过则为0 |
`data`中的`upower_rank`对象： `data`中的`upower_rank`对象：
@@ -280,12 +283,12 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
`upower_rank`中的`list`数组： `upower_rank`中的`list`数组：
| 项 | 类型 | 内容 | 备注 | | 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- | | ---- | ---- | --------- | -------------------------- |
| 0 | obj | 用户1 | | | 0 | obj | 用户1 | |
| n | obj | 用户(n+1) | 按照充电时间排序 | | n | obj | 用户(n+1) | 按照最初充电时间排序（？） |
| …… | obj | …… | …… | | …… | obj | …… | …… |
数组`list`中的对象： `list`数组中的对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | --------------- | ---- | | -------- | ---- | --------------- | ---- |
@@ -308,14 +311,19 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \
| avatar | str | UP主头像url | | | avatar | str | UP主头像url | |
| nickname | str | UP主昵称 | | | nickname | str | UP主昵称 | |
`data`中的`upower_right_count`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | -------------------- | ---- |
| {充电档位代码} | num | 该档位下的充电权益数 | |
**示例：** **示例：**
获取`mid=293793435`的包月充电详情 获取`mid=1265680561`的包月充电详情
```shell ```shell
curl 'https://api.bilibili.com/x/upower/item/detail' \ curl 'https://api.bilibili.com/x/upower/item/detail' \
--data-urlencode 'up_mid=293793435' \ --data-urlencode 'up_mid=1265680561' \
-b 'SESSDATA=xxx' -b 'SESSDATA=xxx'
``` ```
@@ -329,14 +337,26 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \
"ttl": 1, "ttl": 1,
"data": { "data": {
"upower_rank": { "upower_rank": {
"total": 1, "total": 5082,
"total_desc": "1+", "total_desc": "5000+",
"list": [ "list": [
{ {
"rank": 1, "rank": 1,
"mid": 425503913, "mid": 1476475459,
"nickname": "晨叶梦春", "nickname": "一只屑椒",
"avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg" "avatar": "https://i1.hdslb.com/bfs/face/dc721da215f4651e0472d566b146ee8fdf198dbe.jpg"
},
{
"rank": 2,
"mid": 275365317,
"nickname": "-陪我去看海吧i",
"avatar": "https://i0.hdslb.com/bfs/face/dd7547b13020e7f47549ad7908fd3fc58efadefc.jpg"
},
{
"rank": 3,
"mid": 401909111,
"nickname": "Vege5able",
"avatar": "https://i2.hdslb.com/bfs/face/46b1fdc94c7851ec0c47817adeec13e3225da559.jpg"
} }
] ]
}, },
@@ -345,9 +365,29 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \
"welcomes": "哈喽b站的小伙伴们，我的充电计划升级啦！ 感兴趣就多多支持我吧~(゜-゜)つロ" "welcomes": "哈喽b站的小伙伴们，我的充电计划升级啦！ 感兴趣就多多支持我吧~(゜-゜)つロ"
}, },
"user_card": { "user_card": {
"avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", "avatar": "https://i1.hdslb.com/bfs/face/5ddddba98f0265265662a8f7d5383e528a98412b.jpg",
"nickname": "社会易姐QwQ" "nickname": "永雏塔菲"
} },
"upower_level": 1,
"elec_reply_state": 1,
"voucher_state": {
"voucher_order_id": "95843e812210c455d1ea6e4714bf105a00",
"user_voucher_state": 2,
"vip_action": 0,
"voucher_name": "包月充电券（6元档）",
"validate_price": 0,
"validate_level": 0,
"activity": "",
"common_time": 0,
"high_level_time": 0,
"specify_up": 0,
"specify_level": 0
},
"upower_right_count": {
"10": 3
},
"only_contain_medal": false,
"privilege_type": 0
} }
} }
``` ```
@@ -382,14 +422,18 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \
`data`对象： `data`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---------------- | ---- | ------------------------ | ------------------------------------------- | | ------------------ | ---- | ------------------------------ | ------------------------------------------- |
| days | num | 已保持多少天包月充电状态 | | | days | num | 已保持多少天包月充电状态 | |
| up_card | obj | UP主信息 | | | up_card | obj | UP主信息 | |
| user_card | obj | 自己的信息 | | | user_card | obj | 自己的信息 | |
| remain_days | num | 剩余天数 | 未处于包月充电状态为-1 | | remain_days | num | 剩余天数 | 未处于包月充电状态为-1 |
| remain_less_1day | num | 剩余的天数小于1天 | 0：否<br />1：是<br />未处于包月充电状态为0 | | remain_less_1day | num | 剩余的天数是否小于1天 | 0：否<br />1：是<br />未处于包月充电状态为0 |
| upower_rank | obj | 充电详情 | | | upower_rank | obj | 充电详情 | |
| upower_icon | str | 充电图标url | 仅在处于包月充电状态时有内容 | | upower_icon | str | 充电图标url | 仅在处于包月充电状态时有内容 |
| upower_right_count | obj | 当前自己享有该UP主的充电权益数 | |
| only_contain_medal | bool | 享有的权益仅为粉丝勋章 | |
| privilege_type | num | 当前给该UP主包月充电的档位代码 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价)，若未处于包月充电状态为0 |
| challenge_info | obj | 充电挑战信息 | **详细信息有待补充** |
`data`中的`up_card`对象： `data`中的`up_card`对象：
@@ -436,7 +480,6 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \
获取与`mid=293793435`的包月充电关系 获取与`mid=293793435`的包月充电关系
```shell ```shell
curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
--data-urlencode 'up_mid=293793435' \ --data-urlencode 'up_mid=293793435' \
@@ -477,7 +520,23 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
} }
] ]
}, },
"upower_icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png" "upower_icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png",
"upower_right_count": 2,
"only_contain_medal": false,
"privilege_type": 10,
"challenge_info": {
"challenge_id": "",
"description": "",
"challenge_type": 0,
"remaining_days": 0,
"end_time": "",
"progress": 0,
"targets": [],
"state": 0,
"end_time_unix": 0,
"pub_dyn": 0,
"dyn_content": ""
}
} }
} }
``` ```
@@ -497,10 +556,11 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
**url参数：** **url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | -------- | | -------------- | ---- | ------------ | ------ | --------- |
| up_mid | num | 目标用户mid | 必要 | | | up_mid | num | 目标用户mid | 必要 | |
| ps | num | 每页项数 | 非必要 | 默认为20 | | ps | num | 每页项数 | 必要 | 最大为101 |
| pn | num | 页码 | 非必要 | 默认为1 | | pn | num | 页码 | 必要 | |
| privilege_type | num | 充电档位代码 | 非必要 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价)，默认为可以显示排名的档位中**最高定价**的档位 |
**json回复：** **json回复：**
@@ -516,21 +576,26 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
`data`对象： `data`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------ | ----- | ------------ | ---- | | -------------- | ----- | ------------------------------ | -------- |
| up_info | obj | UP主信息 | | | up_info | obj | UP主信息 | |
| rank_info | array | 充电用户排名 | | | rank_info | array | 当前档位的充电用户排名 | |
| user_info | obj | 自己的信息 | | | user_info | obj | 自己在该档位下与UP主的充电关系 | |
| member_total | num | 充电用户总数 | | | member_total | num | 当前档位的充电用户总数 | |
| privilege_type | num | 当前充电档位代码 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价) |
| is_charge | bool | 自己是否给该UP主包月充电过 | 无论档位 |
| tabs | array | 可显示排名的充电档位代码列表 | |
| level_info | array | 可显示排名的充电档位信息 | |
`data`中的`up_info`对象： `data`中的`up_info`对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------ | ---------------------------------------- | | ------------ | ---- | -------------------- | ---------------------------------------- |
| mid | num | UP主mid | | | mid | num | UP主mid | |
| nickname | str | UP主昵称 | | | nickname | str | UP主昵称 | |
| avatar | str | UP主头像url | | | avatar | str | UP主头像url | |
| type | num | UP主认证类型 | -1：无<br />0：UP主认证<br />1：机构认证 | | type | num | UP主认证类型 | -1：无<br />0：UP主认证<br />1：机构认证 |
| title | str | UP主认证文字 | | | title | str | UP主认证文字 | |
| upower_state | num | UP主充电功能开启状态 | 0：未开通充电功能<br />1：已开通自定义充电<br />2：已开通包月、自定义充电<br />3：已开通包月高档、自定义充电 |
`data`中的`rank_info`数组： `data`中的`rank_info`数组：
@@ -559,18 +624,45 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
| mid | num | 用户mid | | | mid | num | 用户mid | |
| nickname | str | 用户昵称 | | | nickname | str | 用户昵称 | |
| avatar | str | 用户头像url | | | avatar | str | 用户头像url | |
| rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 | | rank | num | 包月充电排名 | 不在该充电档位用户列表里为-1 |
| day | num | 包月充电天数 | | | day | num | 包月充电天数 | |
| expire_at | num | 包月充电过期时间 | 秒级时间戳，若从未给UP主包月充电为0 | | expire_at | num | 包月充电过期时间 | 秒级时间戳，若从未给UP主在该档位下包月充电过为0 |
| remain_days | num | 未过期时：剩余天数<br />已过期且之前给UP主包月充电过：自过期以来的天数 | | | remain_days | num | 剩余天数 | 若该档位充电状态已失效为0 |
`data`中的`tabs`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---------------- |
| 0 | num | 档位代码1 | |
| n | num | 档位代码(n+1) | |
| …… | num | …… | …… |
`data`中的`level_info`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 档位1 | |
| n | obj | 档位(n+1) | |
| …… | obj | …… | …… |
`level_info`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | -------------------- | ---------------------- |
| privilege_type | num | 当前充电档位代码 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价) |
| name | str | 档位名称 | |
| price | num | 档位价格 | 单位为百分之一元人民币 |
| member_total | num | 当前档位的用户总数 | |
**示例：** **示例：**
获取给`mid=293793435`包月充电的用户排名 获取给`mid=686127`包月充电的用户排名
```shell ```shell
curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
--data-urlencode 'up_mid=293793435' \ --data-urlencode 'up_mid=686127' \
--data-urlencode 'ps=3' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx' -b 'SESSDATA=xxx'
``` ```
@@ -584,19 +676,38 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
"ttl": 1, "ttl": 1,
"data": { "data": {
"up_info": { "up_info": {
"mid": 293793435, "mid": 686127,
"nickname": "社会易姐QwQ", "nickname": "籽岷",
"avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", "avatar": "https://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp",
"type": -1, "type": 0,
"title": "" "title": "2024百大UP主、知名游戏UP主",
"upower_state": 3
}, },
"rank_info": [ "rank_info": [
{ {
"mid": 425503913, "mid": 187012867,
"nickname": "晨叶梦春", "nickname": "是我灬不配",
"avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg", "avatar": "https://i1.hdslb.com/bfs/face/ad4d2ce0705fd766a0ade315f5a6a5984ce479f4.jpg",
"rank": 1, "rank": 1,
"day": 31, "day": 682,
"expire_at": 0,
"remain_days": 0
},
{
"mid": 20135495,
"nickname": "和平时一样鸽",
"avatar": "https://i2.hdslb.com/bfs/face/0eef725964105f39b1f000a59f232d9094017544.jpg",
"rank": 2,
"day": 620,
"expire_at": 0,
"remain_days": 0
},
{
"mid": 490065730,
"nickname": "乔治Y-GYhaha",
"avatar": "https://i1.hdslb.com/bfs/face/e1753e1e43d7a7df5333c5a2f4d3ec1d0334ebe6.jpg",
"rank": 3,
"day": 527,
"expire_at": 0, "expire_at": 0,
"remain_days": 0 "remain_days": 0
} }
@@ -605,12 +716,29 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
"mid": 425503913, "mid": 425503913,
"nickname": "晨叶梦春", "nickname": "晨叶梦春",
"avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg", "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg",
"rank": 1, "rank": -1,
"day": 31, "day": 0,
"expire_at": 1678723199, "expire_at": 0,
"remain_days": 15 "remain_days": 0
}, },
"member_total": 1 "member_total": 46881,
"privilege_type": 50,
"is_charge": false,
"tabs": [50, 10],
"level_info": [
{
"privilege_type": 50,
"name": "审稿",
"price": 12800,
"member_total": 1082
},
{
"privilege_type": 10,
"name": "石粒",
"price": 600,
"member_total": 46158
}
]
} }
} }
``` ```

18
docs/message/private_msg.md
View File

@@ -738,7 +738,7 @@ curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/session_detail'
| ----------------- | ---- | ---------------- | ------ | ------------------------------------------------------ | | ----------------- | ---- | ---------------- | ------ | ------------------------------------------------------ |
| talker_id | num | 聊天对象的id | 必要 | `session_type` 为 `1` 时表示用户 mid，为 `2` 时表示粉丝团 id | | talker_id | num | 聊天对象的id | 必要 | `session_type` 为 `1` 时表示用户 mid，为 `2` 时表示粉丝团 id |
| session_type | num | 聊天对象的类型 | 必要 | 1：用户<br />2：粉丝团 | | session_type | num | 聊天对象的类型 | 必要 | 1：用户<br />2：粉丝团 |
| size | num | 返回消息数量 | 非必要 | 默认为 0，最大为 200 <br />本参数不存在时，只返回系统提示 | | size | num | 返回消息数量 | 非必要 | 默认为 0，最大为 2000<br />当本参数为 `0` 或不存在时，只返回系统提示 |
| begin_seqno | num | 开始的序列号 | 非必要 | 提供本参数时返回以本序列号开始（不包括本序列号）的消息 | | begin_seqno | num | 开始的序列号 | 非必要 | 提供本参数时返回以本序列号开始（不包括本序列号）的消息 |
| end_seqno | num | 结束的序列号 | 非必要 | 提供本参数时返回以本序列号结束（不包括本序列号）的消息 | | end_seqno | num | 结束的序列号 | 非必要 | 提供本参数时返回以本序列号结束（不包括本序列号）的消息 |
| sender_device_id | num | 发送者设备 | 非必要 | 默认为 `1` | | sender_device_id | num | 发送者设备 | 非必要 | 默认为 `1` |
@@ -1259,15 +1259,15 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack' \
调用该接口会将该会话设置为已读 调用该接口会将该会话设置为已读
**URL参数:** **URL参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 | | 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --- | --- | --- | --- | --- | | ------------- | ---- | --------------- | ------ | ------------------------------------ |
| w_sender_uid | num | 发送者mid | 必要 | 必须为自己的 mid | | w_sender_uid | num | 发送者mid | 非必要 | 同正文参数 `msg[sender_uid]` |
| w_receiver_id | num | 接收者id | 必要 | 请求参数 `msg[receiver_type]` 为 `1` 时表示用户 mid，为 `2` 时表示粉丝团 id | | w_receiver_id | num | 接收者id | 非必要 | 同正文参数 `msg[receiver_id]` |
| w_dev_id | str | 设备id | 必要 | 实质上即 UUID（版本 4），**生成方式见下** | | w_dev_id | str | 设备id | 非必要 | 同正文参数 `msg[dev_id]` |
| w_rid | str | Wbi 签名 | 必要 | 参见 [Wbi 签名](../misc/sign/wbi.md) | | w_rid | str | Wbi 签名 | 非必要 | 参见 [Wbi 签名](../misc/sign/wbi.md) |
| wts | str | UNIX 秒级时间戳 | 必要 | 参见 [Wbi 签名](../misc/sign/wbi.md) | | wts | str | UNIX 秒级时间戳 | 非必要 | 参见 [Wbi 签名](../misc/sign/wbi.md) |
**正文参数（application/x-www-form-urlencoded）：** **正文参数（application/x-www-form-urlencoded）：**
@@ -1281,7 +1281,7 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack' \
| msg\[dev_id\] | str | 设备id | 必要 | 实质上即 UUID（版本 4），**生成方式见下** | | msg\[dev_id\] | str | 设备id | 必要 | 实质上即 UUID（版本 4），**生成方式见下** |
| msg\[timestamp\] | num | 当前时间戳（秒） | 必要 | | | msg\[timestamp\] | num | 当前时间戳（秒） | 必要 | |
| msg\[new_face_version\] | num | 表情包版本 | 非必要 | 提供 `0` 或者未提供本参数表示旧版表情包，此时 B 站会自动转换成新版表情包，例如 `[doge]` -> `[tv_doge]`；`1` 为新版 | | msg\[new_face_version\] | num | 表情包版本 | 非必要 | 提供 `0` 或者未提供本参数表示旧版表情包，此时 B 站会自动转换成新版表情包，例如 `[doge]` -> `[tv_doge]`；`1` 为新版 |
| msg\[content\] | str | 消息内容 | 必要 | 详见[私信消息类型、内容说明](private_msg_content.md) | | msg\[content\] | str | 消息内容 | 必要 | 详见[私信消息类型、内容说明](private_msg_content.md)，接受最多2000字节的内容 |
| csrf_token | str | CSRF Token（位于cookie） | 必要 | | | csrf_token | str | CSRF Token（位于cookie） | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | | | csrf | str | CSRF Token（位于cookie） | 必要 | |
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` | | build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |

14
docs/message/private_msg_content.md
View File

@@ -28,7 +28,7 @@
在发送私信时，请确保下面的对象合法且 `url` 项的值为 B 站的图床 url，否则会报 21037 `图片格式不合法，不要调戏接口啦` 错误 在发送私信时，请确保下面的对象合法且 `url` 项的值为 B 站的图床 url，否则会报 21037 `图片格式不合法，不要调戏接口啦` 错误
建议设置 `height` 与 `width` 属性，否则可能会导致消息显示异常 建议设置 `height` 与 `width` 属性为图片的尺寸，否则可能会导致消息显示异常
根对象： 根对象：
@@ -176,12 +176,12 @@
| ----------------- | ----- | ------------- | ------------------------- | | ----------------- | ----- | ------------- | ------------------------- |
| title | str | 通知标题 | | | title | str | 通知标题 | |
| text | str | 通知内容 | | | text | str | 通知内容 | |
| jump_text | str | 按钮1提示文字 | 若按钮1不存在则为空；若按钮1存在此项也可能为空，此时前端显示文字为 `查看详情` | | jump_text | str | 按钮1提示文字 | 若按钮1不存在则为空；若按钮1存在，此项也可能为空，此时前端显示文字为 `查看详情` |
| jump_uri | str | 按钮1跳转链接 | 若按钮1不存在则为空 | | jump_uri | str | 按钮1跳转链接 | 若按钮1不存在则为空 |
| modules | 有效时：array<br />无效时：null | 详细信息 | | | modules | 有效时：array<br />无效时：null | 详细信息 | |
| jump_text_2 | str | 按钮2提示文字 | 若按钮2不存在则为空；若按钮2存在此项也可能为空，此时前端显示文字为 `查看详情` | | jump_text_2 | str | 按钮2提示文字 | 若按钮2不存在则为空；若按钮2存在，此项也可能为空，此时前端显示文字为 `查看详情` |
| jump_uri_2 | str | 按钮2跳转链接 | 若按钮2不存在则为空 | | jump_uri_2 | str | 按钮2跳转链接 | 若按钮2不存在则为空 |
| jump_text_3 | str | 按钮3提示文字 | 若按钮3不存在则为空；若按钮3存在此项也可能为空，此时前端显示文字为 `查看详情` | | jump_text_3 | str | 按钮3提示文字 | 若按钮3不存在则为空；若按钮3存在，此项也可能为空，此时前端显示文字为 `查看详情` |
| jump_uri_3 | str | 按钮3跳转链接 | 若按钮3不存在则为空 | | jump_uri_3 | str | 按钮3跳转链接 | 若按钮3不存在则为空 |
| notifier | 有效时：obj<br />无效时：null | 发送者信息 | | | notifier | 有效时：obj<br />无效时：null | 发送者信息 | |
| jump_uri_config | obj | 按钮1配置 | | | jump_uri_config | obj | 按钮1配置 | |
@@ -523,7 +523,7 @@
根对象： 根对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------- | | ------- | ---- | -------- | -------------------------- |
| content | str | 提示列表 | **经过序列化后**的JSON数组 | | content | str | 提示列表 | **经过序列化后**的JSON数组 |
`content`文本经JSON解析后的数组： `content`文本经JSON解析后的数组：
@@ -602,8 +602,8 @@
根对象： 根对象：
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | -------- | ---- | | -------- | ---- | -------- | ---------- |
| group_id | num | 粉丝团id | | | group_id | num | 粉丝团id | （非必要） |
| content | str | 提示文字 | | | content | str | 提示文字 | |
**示例：** **示例：**

2
docs/user/info.md
View File

@@ -318,7 +318,7 @@
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ---------------- | ---------------- | | -------- | ---- | ---------------- | ---------------- |
| show | bool | 是否显示充电按钮 | | | show | bool | 是否显示充电按钮 | |
| state | num | 充电功能开启状态 | -1：未开通充电功能<br />1：已开通自定义充电<br />2：已开通包月、自定义充电<br />3：已开通高档、自定义充电 | | state | num | 充电功能开启状态 | -1：未开通充电功能<br />1：已开通自定义充电<br />2：已开通包月、自定义充电<br />3：已开通包月高档、自定义充电 |
| title | str | 充电按钮显示文字 | 空字符串或 `充电` 或 `充电中` | | title | str | 充电按钮显示文字 | 空字符串或 `充电` 或 `充电中` |
| icon | str | 充电图标 | | | icon | str | 充电图标 | |
| jump_url | str | 跳转url | | | jump_url | str | 跳转url | |