返回提交历史
Modified
README.md
+1
-1
Added
docs/message/settings.md
+164
-0
XFEstudio/bilibili-API-collect
feat(message/settings): add get sys setting
Signed-off-by: 晨叶梦春 <65224318+wuziqian211@users.noreply.github.com>
0ba4aef
代码差异
2 个文件
+165
-1
@@ -94,7 +94,7 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
94
94
- [ ] [通知类消息](docs/message/msg.md)
95
95
- [ ] [私信](docs/message/private_msg.md)
96
96
- [ ] [私信消息类型、内容说明](docs/message/private_msg_content.md)
97
- [ ] 设置
97
- [ ] [设置](docs/message/settings.md)
98
98
- [ ] [用户](docs/user)
99
99
- [x] [基本信息](docs/user/info.md)
100
100
- [x] [状态数](docs/user/status_number.md)
@@ -0,0 +1,164 @@
1
# 消息设置
2
3
## 获取系统设置
4
5
> <https://api.vc.bilibili.com/link_setting/v1/link_setting/get_sys_setting>
6
7
*请求方式：GET*
8
9
认证方式：Cookie（SESSDATA）
10
11
此接口中的设置一般不能由用户随意更改
12
13
**url参数：**
14
15
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
16
| -------- | ---- | ---------------- | ------ | ------------------------- |
17
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
18
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
19
20
**json回复：**
21
22
根对象：
23
24
| 字段 | 类型 | 内容 | 备注 |
25
| ------- | ---- | -------- | ----------------------------- |
26
| code | num | 返回值 | 0：成功<br />-101：账号未登录 |
27
| msg | str | 错误信息 | 默认为0 |
28
| message | str | 错误信息 | 默认为0 |
29
| ttl | num | 1 | |
30
| data | obj | 信息本体 | |
31
32
`data` 对象：
33
34
| 字段 | 类型 | 内容 | 备注 |
35
| --------------------------------- | ---- | ---------------------------------------------------------------------------------------- | -------------------------- |
36
| is_create_group_available | num | 是否可创建粉丝团 | 粉丝数达到 1000 后开启 |
37
| is_auto_reply_available | num | 是否可使用自动回复功能 | 粉丝数达到 1000 后开启 |
38
| vc_hint_title | str | 稿件自动推送小灰条内容 | `我为什么会收到此类消息` |
39
| vc_hint_title_button | str | 稿件自动推送小灰条旁的按钮内容 | `了解更多` |
40
| vc_hint_detail | str | 稿件自动推送详细信息小灰条内容 | `您【特别关注】的UP主更新视频或专栏后，会第一时间在私信推送给您。如有需要可点击右上角设置关闭推送。` |
41
| vc_hint_detail_button | str | 关闭稿件自动推送按钮内容 | `关闭推送` |
42
| auto_reply_html | str | 自动回复H5页面url | `https://message.bilibili.com/h5/app/auto-reply` |
43
| is_receive_unfollow_wl | num | 是否显示限制接收未关注人消息功能 | |
44
| is_voyage | num | 是否在自动回复页面显示 “大航海自动回复” 按钮 | 仅部分用户开启 |
45
| is_auto_reply_recommend_available | num | 是否在自动回复中的 “被关注回复” 页面显示 “被关注后，向关注我的人推送我的往期作品” 复选框 | 仅部分用户开启 |
46
| is_discuss_style_im_page | num | （？） | **作用尚不明确** |
47
| discuss_unread_style_im_page | num | （？） | **作用尚不明确** |
48
| old_up_assistant_door | obj | 原 “UP主小助手” 入口相关信息 | |
49
| is_new_up_assistant_effective | num | 新 “UP主小助手” 是否启用 | |
50
| is_archive_gray | bool | 是否不显示 “私信存档” 按钮 | |
51
| session_cfg | obj | 特定私信会话配置信息 | |
52
| migrate_session_api | bool | （？） | **作用尚不明确** |
53
| game_msg | obj | （？） | **作用尚不明确**；仅当请求参数 `mobi_app` 不为 `web` 时有其中的项目 |
54
| auto_reply_msg_desc | str | 指示消息为自动回复消息的提示内容 | `此条消息为自动回复` |
55
| huahuo_group_icon_new | str | 浅色模式下的花火图标url | |
56
| huahuo_group_icon_dark_new | str | 深色模式下的花火图标url | |
57
| im_disabled_input_hint | str | 某UP主禁用私信功能时的提示内容 | `请到UP主空间发起咨询` |
58
59
`data` 中的 `old_up_assistant_door` 对象：
60
61
| 字段 | 类型 | 内容 | 备注 |
62
| ---------------- | ---- | ---------------------------- | ------------ |
63
| show_old_up_door | num | 是否显示原 “UP主小助手” 入口 | 目前恒为 `0` |
64
| title | str | 原 “UP主小助手” 入口标题 | 目前为空文本 |
65
| sub_title | str | 原 “UP主小助手” 入口子标题 | 目前为空文本 |
66
67
`data` 中的 `session_cfg` 对象：
68
69
| 字段 | 类型 | 内容 | 备注 |
70
| --------- | ---- | ---------------- | ---- |
71
| {用户mid} | obj | 该会话的配置信息 | |
72
73
`session_cfg` 中的 `{用户mid}` 对象：
74
75
| 字段 | 类型 | 内容 | 备注 |
76
| ---------------- | ---- | -------------------- | ------------------- |
77
| hidden_emote_btn | bool | 是否隐藏表情按钮 | |
78
| hidden_pic_btn | bool | 是否隐藏发送图片按钮 | |
79
| max_height | num | 最大高度（？） | **作用尚不明确** |
80
| hint_text | str | 私信输入框的提示内容 | `你想问什么问题呢?` |
81
| hidden_top_hint | str | （？） | **作用尚不明确** |
82
| is_gpt_account | bool | 是否为AI会话 | |
83
84
`data` 中的 `game_msg` 对象：
85
86
| 字段 | 类型 | 内容 | 备注 |
87
| ------------ | ---- | ---- | ------------------------------------------------------------- |
88
| show_install | bool | true | **作用尚不明确**；仅当请求参数 `mobi_app` 不为 `web` 时有此项 |
89
90
**示例：**
91
92
```shell
93
curl 'https://api.vc.bilibili.com/link_setting/v1/link_setting/get_sys_setting' \
94
-b 'SESSDATA=xxx'
95
```
96
97
<details>
98
<summary>查看响应示例：</summary>
99
100
```json
101
{
102
"code": 0,
103
"msg": "0",
104
"message": "0",
105
"ttl": 1,
106
"data": {
107
"is_create_group_available": 1,
108
"is_auto_reply_available": 1,
109
"vc_hint_title": "我为什么会收到此类消息",
110
"vc_hint_title_button": "了解更多",
111
"vc_hint_detail": "您【特别关注】的UP主更新视频或专栏后，会第一时间在私信推送给您。如有需要可点击右上角设置关闭推送。",
112
"vc_hint_detail_button": "关闭推送",
113
"auto_reply_html": "https://message.bilibili.com/h5/app/auto-reply",
114
"is_receive_unfollow_wl": 0,
115
"is_voyage": 1,
116
"is_auto_reply_recommend_available": 0,
117
"is_discuss_style_im_page": 0,
118
"discuss_unread_style_im_page": 0,
119
"old_up_assistant_door": {
120
"show_old_up_door": 0,
121
"title": "",
122
"sub_title": ""
123
},
124
"is_new_up_assistant_effective": 1,
125
"is_archive_gray": true,
126
"session_cfg": {
127
"100000000000001": {
128
"hidden_emote_btn": true,
129
"hidden_pic_btn": true,
130
"max_height": 62,
131
"hint_text": "你想问什么问题呢?",
132
"hidden_top_hint": true,
133
"is_gpt_account": true
134
},
135
"100000000000002": {
136
"hidden_emote_btn": true,
137
"hidden_pic_btn": true,
138
"max_height": 62,
139
"hint_text": "你想问什么问题呢?",
140
"hidden_top_hint": true,
141
"is_gpt_account": true
142
},
143
"1400565964": {
144
"hidden_emote_btn": true,
145
"hidden_pic_btn": true,
146
"max_height": 62,
147
"hint_text": "你想问什么问题呢?",
148
"hidden_top_hint": true,
149
"is_gpt_account": true
150
}
151
},
152
"migrate_session_api": false,
153
"game_msg": {
154
"show_install": true
155
},
156
"auto_reply_msg_desc": "此条消息为自动回复",
157
"huahuo_group_icon_new": "http://i0.hdslb.com/bfs/kfptfe/floor/e2e3829e514ebccab1705636b0354ec89446a4b5.png",
158
"huahuo_group_icon_dark_new": "http://i0.hdslb.com/bfs/kfptfe/floor/d09bc8c0716a15938ec427db5fa962733703f3ce.png",
159
"im_disabled_input_hint": "请到UP主空间发起咨询"
160
}
161
}
162
```
163
164
</details>