返回提交历史
Modified
docs/message/private_msg.md
+1
-1
Modified
docs/message/private_msg_content.md
+166
-0
Modified
docs/user/relation.md
+1
-3
XFEstudio/bilibili-API-collect
update
e6072a6
代码差异
3 个文件
+168
-4
@@ -352,7 +352,7 @@ public class Main {
352
352
353
353
| 字段 | 类型 | 内容 | 备注 |
354
354
| ------- | ---- | -------- | ------------------------------------------------- |
355
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />10005：msgkey不存在<br />21007：消息过长，无法发送<br />21026：不能给自己发送消息哦~<br />21035：该类消息暂时无法发送<br />21037：图片格式不合法，不要调戏接口啦<br />21041：消息已超期，不能撤回了哦<br />21042：消息已经撤回了哦<br />21046：你发消息的频率太高了，请在24小时后再发吧~<br />21047：你最多发送1条消息，对方回复或者关注你后可以继续发消息~ |
355
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />10005：msgkey不存在<br />21007：消息过长，无法发送<br />21026：不能给自己发送消息哦~<br />21035：该类消息暂时无法发送<br />21037：图片格式不合法，不要调戏接口啦<br />21041：消息已超期，不能撤回了哦<br />21042：消息已经撤回了哦<br />21046：你发消息的频率太高了，请在24小时后再发吧~<br />21047：对方主动回复或关注你前，最多发送1条消息~ |
356
356
| message | str | 错误信息 | 成功时为0 |
357
357
| ttl | num | | 默认为1 |
358
358
| data | 有效时：obj<br />无效时：null | 信息本体 | |
@@ -80,16 +80,152 @@
80
80
81
81
此类型消息仅可接收，不可直接发送
82
82
83
根对象：
84
85
| 字段 | 类型 | 内容 | 备注 |
86
| ----------------- | ----- | ------------- | ------------------------- |
87
| title | str | 通知标题 | |
88
| text | str | 通知内容 | |
89
| jump_text | str | 按钮1提示文字 | |
90
| jump_uri | str | 按钮1跳转链接 | |
91
| modules | array | 详细信息 | |
92
| jump_text_2 | str | 按钮2提示文字 | |
93
| jump_uri_2 | str | 按钮2跳转链接 | |
94
| jump_text_3 | str | 按钮3提示文字 | |
95
| jump_uri_3 | str | 按钮3跳转链接 | |
96
| notifier | obj | 发送者信息 | |
97
| jump_uri_config | obj | 按钮1配置 | |
98
| jump_uri_2_config | obj | 按钮2配置 | |
99
| jump_uri_3_config | obj | 按钮3配置 | |
100
| biz_content | obj | 扩展信息 | |
101
102
**示例：**
103
104
```json
105
{
106
"title": "直播开始提醒",
107
"text": "你预约的直播已开始，快来围观吧~",
108
"jump_text": "进入直播间",
109
"jump_uri": "https://live.bilibili.com/22747055?broadcast_type=0&is_room_feed=1&live_from=27040",
110
"modules": [
111
{
112
"title": "预约主题",
113
"detail": "2024哔哩哔哩拜年纪"
114
},
115
{
116
"title": "开播时间",
117
"detail": "2024-02-09 19:32"
118
},
119
{
120
"title": "UP主",
121
"detail": "哔哩哔哩拜年纪"
122
}
123
],
124
"jump_text_2": "",
125
"jump_uri_2": "",
126
"jump_text_3": "",
127
"jump_uri_3": "",
128
"notifier": null,
129
"jump_uri_config": {
130
"all_uri": "https://live.bilibili.com/22747055?broadcast_type=0&is_room_feed=1&live_from=27040",
131
"text": "进入直播间"
132
},
133
"jump_uri_2_config": {
134
"text": ""
135
},
136
"jump_uri_3_config": {
137
"text": ""
138
},
139
"biz_content": {
140
"cover": "",
141
"backup_cover": "http://i0.hdslb.com/bfs/live/new_room_cover/bdae2665883ec8aa4e79aca16f3c5ee2df1da64f.jpg",
142
"refresh_type": 1,
143
"biz_type": 2,
144
"biz_id1": "1868902080",
145
"biz_id2": "473923647994271663",
146
"biz_status": 0
147
}
148
}
149
```
83
150
84
151
## 视频推送消息（`msg_type=11`）
85
152
86
153
此类型消息仅可接收，不可直接发送
87
154
155
根对象：
156
157
| 字段 | 类型 | 内容 | 备注 |
158
| ---------- | ---- | ------------ | ------------------------------------------------------ |
159
| title | str | 视频标题 | 接收私信时实时更新此项，若视频失效则为空文本 |
160
| times | num | 视频时长 | 以秒为单位，接收私信时实时更新此项，若视频失效则为 `0` |
161
| cover | str | 视频封面 | 接收私信时实时更新此项，若视频失效则为空文本 |
162
| rid | num | 视频AV号 | |
163
| type_ | num | （？） | **作用尚不明确** |
164
| desc | str | 视频简介 | 接收私信时实时更新此项，若视频失效则为空文本 |
165
| bvid | str | 视频BV号 | |
166
| view | num | 视频播放量 | 接收私信时实时更新此项，若视频失效则为 `0` |
167
| danmaku | num | 视频弹幕数 | 接收私信时实时更新此项，若视频失效则为 `0` |
168
| pub_date | num | 视频发布时间 | 秒级时间戳，若视频失效则为 `0` |
169
| attach_msg | 有效时：obj<br />无效时：null | UP主赠言 | |
170
171
**示例：**
172
173
```json
174
{
175
"title": "【2023嵌入式大赛】浅浅测试一下龙芯开发板",
176
"times": 308,
177
"cover": "http://i2.hdslb.com/bfs/archive/880c937de9af758451aa94ee29771e0264c1903a.jpg",
178
"rid": 740817783,
179
"type_": 8,
180
"desc": "最近把龙芯开发板部分（任务一）程序完成了，时间非常紧迫，就不知道为啥突然给省赛加个（本来国赛的题\n从硬件焊接开始，到软件整完不过5天啊喂，肝疼，过几天比赛完发硬件制作过程\n硬件使用龙芯一号（LS1B010）SOC，软件使用 C 语言+FreeRTOS+VSCode 开发",
181
"bvid": "BV1Dk4y1E7MZ",
182
"view": 13492,
183
"danmaku": 5,
184
"pub_date": 1683381582,
185
"attach_msg": null
186
}
187
```
88
188
89
189
## 专栏推送消息（`msg_type=12`）
90
190
91
191
此类型消息仅可接收，不可直接发送
92
192
193
根对象：
194
195
| 字段 | 类型 | 内容 | 备注 |
196
| ----------- | ---- | ------------ | ------------------------------------------------------ |
197
| rid | num | 专栏CV号 | |
198
| title | str | 专栏标题 | 接收私信时实时更新此项，若专栏失效则为 `内容已失效` |
199
| summary | str | 专栏内容概要 | 接收私信时实时更新此项，若专栏失效则为空文本 |
200
| author | str | 专栏UP主昵称 | 接收私信时实时更新此项，若专栏失效则为空文本 |
201
| view | num | 专栏观看数 | 接收私信时实时更新此项，若专栏失效则为 `0` |
202
| like | num | 专栏点赞数 | 接收私信时实时更新此项，若专栏失效则为 `0` |
203
| reply | num | 专栏评论数 | 接收私信时实时更新此项，若专栏失效则为 `0` |
204
| template_id | num | （？） | **作用尚不明确** |
205
| image_urls | 有效时：array<br />无效时：null | 专栏封面列表 | 接收私信时实时更新此项，若专栏失效则为 `null` |
206
| attach_msg | 有效时：obj<br />无效时：null | UP主赠言 | |
207
| pub_date | num | 专栏发布时间 | 秒级时间戳，若专栏失效则为 `0` |
208
209
**示例：**
210
211
```json
212
{
213
"rid": 18275013,
214
"title": "【单片机】遛弯捕捉到野生U盾，点亮它！",
215
"summary": "前一阵在学校那会，偶然的机会晚上饭后出去遛弯，在路边看到个被抛弃的 U盾，这么一想应该是附近拆迁搬东西时丢出去的，随即捕捉它。作为一个啥都折腾的捡垃圾技术宅肯定要去研究一波（笑是个建行的 U盾，按键部分还有点老灰，屏幕的尺寸盲猜 128x64，不可能再大了背面除了序列号没有别的东西，顶部有个盖子，像极了上古时期的 U盘插上充电宝可以正常点亮，至少屏没坏拆解&分析电路直接开拆，用刀片沿着四周缝隙插入并挑开卡扣内部结构挺简单，只有两颗较大的芯片，屏幕的 FPC 排线直接焊接在 PCB 上中间的这颗是",
216
"author": "社会易姐QwQ",
217
"view": 872,
218
"like": 38,
219
"reply": 7,
220
"template_id": 4,
221
"image_urls": [
222
"https://i0.hdslb.com/bfs/article/c7c60e018c43c5c3a6e1520239021ea2753b2880.jpg"
223
],
224
"attach_msg": null,
225
"pub_date": 1661358081
226
}
227
```
228
93
229
94
230
## 图片卡片消息（`msg_type=13`）
95
231
@@ -101,3 +237,33 @@
101
237
## 系统提示消息（`msg_type=18`）
102
238
103
239
此类型消息仅可接收，不可直接发送
240
241
根对象：
242
243
| 字段 | 类型 | 内容 | 备注 |
244
| ------- | ----- | -------- | ---- |
245
| content | array | 提示列表 | |
246
247
`content`数组：
248
249
| 项 | 类型 | 内容 | 备注 |
250
| ---- | ---- | --------- | ---------------------- |
251
| 0 | str | 提示1 | 经过序列化后的JSON对象 |
252
| n | str | 提示(n+1) | |
253
| …… | str | …… | …… |
254
255
`content`数组中的JSON文本解析后的对象：
256
257
| 字段 | 类型 | 内容 | 备注 |
258
| --------- | ---- | ------------------------ | ----------- |
259
| text | str | 提示文字 | |
260
| color_day | str | 浅色模式下的提示文字颜色 | HEX颜色代码 |
261
| color_nig | str | 深色模式下的提示文字颜色 | HEX颜色代码 |
262
263
**示例：**
264
265
```json
266
{
267
"content": "[{\"text\":\"对方主动回复或关注你前，最多发送1条消息\",\"color_day\":\"#9499A0\",\"color_nig\":\"#9499A0\"}]"
268
}
269
```
@@ -501,9 +501,7 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
501
501
502
502
</details>
503
503
504
## 查询用户关注明细3
505
506
<img src="../../assets/img/relation.svg" width="100" height="100" />
504
### 查询用户关注明细3
507
505
508
506
> https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list
509
507