返回提交历史
Modified
.vuepress/theme/layouts/Layout.vue
+1
-1
Modified
README.md
+1
-0
Modified
docs/history&toview/history.md
+4
-0
Modified
docs/message/private_msg.md
+344
-226
Added
docs/message/private_msg_content.md.txt
+57
-0
Modified
docs/user/relation.md
+13
-13
XFEstudio/bilibili-API-collect
update
d04d419
代码差异
6 个文件
+420
-240
@@ -2,7 +2,7 @@
2
2
<ParentLayout>
3
3
<template #page-bottom>
4
4
<footer style="text-align: center">
5
Copyright © 2020-2023
5
Copyright © 2020-2024
6
6
<a href="https://github.com/SocialSisterYi/">SocialSisterYi</a> |
7
7
<a
8
8
href="https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/LICENSE"
@@ -87,6 +87,7 @@ B站 API 采用 C/S 结构,大多数接口为 REST API 和 gRPC,少部分接
87
87
- [ ] [消息中心](docs/message)
88
88
- [ ] [通知类消息](docs/message/msg.md)
89
89
- [ ] [私信](docs/message/private_msg.md)
90
- [ ] [私信消息类型、内容说明](docs/message/private_msg_content.md)
90
91
- [ ] 设置
91
92
- [ ] [用户](docs/user)
92
93
- [x] [基本信息](docs/user/info.md)
@@ -10,6 +10,8 @@
10
10
11
11
注:`max`、`business`、`view_at`参数用于历史记录列表的 IFS (无限滚动),其用法类似链表的 next 指针
12
12
13
本接口也可以返回已失效稿件的信息
14
13
15
**url参数:**
14
16
15
17
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@@ -349,6 +351,8 @@ curl -G 'https://api.bilibili.com/x/web-interface/history/cursor' \
349
351
350
352
认证方式:Cookie (SESSDATA)
351
353
354
本接口也可以返回已失效稿件的信息
355
352
356
**url参数:**
353
357
354
358
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@@ -0,0 +1,57 @@
1
# 私信消息类型、内容说明
2
3
## 文字消息(`msg_type=1`)
4
5
根对象:
6
7
| 字段 | 类型 | 内容 | 备注 |
8
| ------- | ---- | -------- | ---- |
9
| content | str | 私信内容 | |
10
11
**示例:**
12
13
```json
14
{
15
"content": "Hello"
16
}
17
```
18
19
## 图片消息(`msg_type=2`)
20
21
根对象:
22
23
| 字段 | 类型 | 内容 | 备注 |
24
| -------- | ---- | ---------- | ------------------------- |
25
| url | str | 图片url | 默认为B站相簿图片上传通道 |
26
| height | num | 图片高度 | 单位:像素(非必要) |
27
| width | num | 图片宽度 | 单位:像素(非必要) |
28
| type | str | 图片格式 | (非必要) |
29
| original | num | 是否为原图 | 当本参数值为`1`时,APP上会出现“下载原图”按钮(非必要) |
30
| size | num | 文件大小 | 单位:千字节(非必要) |
31
32
**示例:**
33
34
```json
35
{
36
"url": "https://message.biliimg.com/bfs/im_new/c161fdf51d901c1607a15e30f10116dd425503913.jpg",
37
"height": 300,
38
"width": 300,
39
"imageType": "jpeg",
40
"original": 1,
41
"size": 55.443
42
}
43
```
44
45
## 撤回消息(`msg_type=5`)
46
47
内容为目标私信的`msg_key`,请确保发送的私信与目标私信在同一会话内;发送此私信后,目标私信的 `msg_status` 会改成 `1`
48
49
**示例:**
50
51
假如存在 `msg_key` 为 `7345551441311046575` 的私信 A,用户发送了 `msg_type` 为 `5` 且 `content` 为以下内容的私信 B:
52
53
```json
54
7345551441311046575
55
```
56
57
这时,私信 A 就会被撤回,并且其 `msg_status` 也会改变成 `1`
@@ -11,7 +11,7 @@
11
11
| 字段 | 类型 | 内容 | 备注 |
12
12
| --------------- | ------------------------------------------- | -------------------------- | ------------------------------------------------------------ |
13
13
| mid | num | 用户 mid | |
14
| attribute | num | 对方对于**自己**的关系属性 | 0:未关注<br />1:悄悄关注(现已下线)<br />2:已关注<br />6:已互粉<br />128:已拉黑 |
14
| attribute | num | 对方对于**自己**的关系属性 | 0:未关注<br />~~1:悄悄关注(现已下线)~~<br />2:已关注<br />6:已互粉<br />128:已拉黑 |
15
15
| mtime | num | 对方关注目标用户时间 | 秒级时间戳<br />互关后刷新 |
16
16
| tag | 默认分组:null<br />存在至少一个分组:array | 目标用户将对方分组到的 id | |
17
17
| special | num | 目标用户特别关注对方标识 | 0:否<br />1:是 |
@@ -97,7 +97,7 @@
97
97
98
98
| 字段 | 类型 | 内容 | 备注 |
99
99
| ------- | ---- | -------- | ----------------------------------------------------- |
100
| code | num | 返回值 | 0:成功<br />-101:账号未登录<br />-352:请求被拦截<br />-400:请求错误<br />22007:访问超过 5 页 |
100
| code | num | 返回值 | 0:成功<br />-101:账号未登录<br />-352:请求被拦截<br />-400:请求错误<br />22118:由于该用户隐私设置,粉丝列表不可见 |
101
101
| message | str | 错误信息 | 默认为 0 |
102
102
| ttl | num | 1 | |
103
103
| data | obj | 信息本体 | |
@@ -368,7 +368,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
368
368
369
369
| 项 | 类型 | 内容 | 备注 |
370
370
| ---- | ---- | ----------- | --------------------------------------------- |
371
| 0 | obj | 关注 1 | 与 [关系列表对象](#关系列表对象) 数据结构不同 |
371
| 0 | obj | 关注 1 | 与 [关系列表对象](#关系列表对象) 数据结构**不同** |
372
372
| n | obj | 关注(n+1) | 按照添加顺序排列 |
373
373
| …… | obj | …… | …… |
374
374
@@ -1289,15 +1289,15 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
1289
1289
1290
1290
操作代码`act`:
1291
1291
1292
| 代码 | 含义 |
1293
| ---- | ------------ |
1294
| 1 | 关注 |
1295
| 2 | 取关 |
1296
| 3 | 悄悄关注 |
1297
| 4 | 取消悄悄关注 |
1298
| 5 | 拉黑 |
1299
| 6 | 取消拉黑 |
1300
| 7 | 踢出粉丝 |
1292
| 代码 | 含义 | 备注 |
1293
| ---- | ------------ | ------------------------------------------------ |
1294
| 1 | 关注 | 无法对已注销或不存在的用户进行此操作 |
1295
| 2 | 取关 | |
1296
| 3 | 悄悄关注 | 现已下线,使用本操作代码请求接口会提示“请求错误” |
1297
| 4 | 取消悄悄关注 | |
1298
| 5 | 拉黑 | 无法对已注销或不存在的用户进行此操作 |
1299
| 6 | 取消拉黑 | |
1300
| 7 | 踢出粉丝 | |
1301
1301
1302
1302
**json回复:**
1303
1303
@@ -1305,7 +1305,7 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
1305
1305
1306
1306
| 字段 | 类型 | 内容 | 备注 |
1307
1307
| ------- | ---- | -------- | ------------------------------------------------------------ |
1308
| code | num | 返回值 | 0:成功<br />-101:账号未登录<br />-102:账号被封停<br />-111:csrf校验失败<br />-400:请求错误<br />22001:不能对自己进行此操作<br />22003:用户位于黑名单 |
1308
| code | num | 返回值 | 0:成功<br />-101:账号未登录<br />-102:账号被封停<br />-111:csrf校验失败<br />-400:请求错误<br />22001:不能对自己进行此操作<br />22003:用户位于黑名单<br />22013:账号已注销,无法完成操作<br />22014:已经关注用户,无法重复关注<br />40061:用户不存在 |
1309
1309
| message | str | 错误信息 | 默认为0 |
1310
1310
| ttl | num | 1 | |
1311
1311