返回提交历史
Modified
README.md
+4
-0
Modified
docs/message/private_msg.md
+3
-1
Added
docs/teenager/teenager_mode.md
+84
-0
XFEstudio/bilibili-API-collect
新增私信消息记录参数，新增青少年模式接口 (#935)
* Update private_msg.md 为私信消息记录添加新的参数 * Add teenager_mode * Update teenager_mode.md 修正格式 * move teenager_mode.md to teenager * add teenager * Update teenager_mode.md
d0f6de0
代码差异
3 个文件
+91
-1
@@ -239,6 +239,10 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
239
239
- [x] [查询信息](docs/newbie_exam/info.md)
240
240
- [x] [拉取题目](docs/newbie_exam/fetch.md)
241
241
- [x] [操作](docs/newbie_exam/action.md)
242
- [ ] [青少年守护](docs/teenager/)
243
- [x] [青少年模式](docs/teenager/teenager_mode.md)
244
- [ ] 亲子平台
245
- [ ] 课堂模式
242
246
- [ ] B币钱包
243
247
- [ ] 基本信息
244
248
- [ ] B币充值
@@ -249,9 +249,11 @@ curl 'https://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \
249
249
| sender_device_id | num | 发送者设备 | 可选 | 1 |
250
250
| talker_id | num | 聊天对象的UID | 必要 | -------------- |
251
251
| session_type | num | 聊天对象的类型 | 必要 | 1为用户，2为粉丝团 |
252
| size | num | 列出消息条数 | 可选 | 默认是20 |
252
| size | num | 列出消息条数 | 可选 | 默认是20，最大为200 |
253
253
| build | num | 未知 | 可选 | 默认是0 |
254
254
| mobi_app | str | 设备 | 可选 | web |
255
| begin_seqno | num | 开始的序列号 | 可选 | 默认0为全部 |
256
| end_seqno | num | 结束的序列号 | 可选 | 默认0为全部 |
255
257
256
258
**json回复：**
257
259
@@ -0,0 +1,84 @@
1
# 青少年模式
2
## 开启/关闭
3
> https://app.bilibili.com/x/v2/account/teenagers/update
4
5
*请求方式：POST*
6
7
认证方式：APP（详见[设备各类标识算法](docs/misc/device_identity.md)）
8
9
**POST参数：**
10
11
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
12
|--------|-----|-------|---------|-----|
13
| appkey | str | APP密钥 | APP必要 | |
14
| ts | num | 当前时间戳 | APP必要 | |
15
| sign | str | APP签名 | APP必要 | |
16
| access_key | str | APP登录Token | APP必要 | |
17
| device_model | str | 设备 Model | APP必要 | |
18
| channel | str | APP下载渠道 | APP必要 | 比如yingyongbao |
19
| mobi_app | str |APP 包类型 | APP必要 | |
20
| platform | str |平台类型| APP必要 | android |
21
| c_locale | str |语言| 非必要 | zh_CN |
22
| s_locale | str |语言| 非必要 | zh_CN |
23
| statistics | str | ? | 必要 | 一般固定为{"appId":1,"platform":3,"version":"7.27.0","abtest":""},非key-value入参需要转URL编码 |
24
| pwd | num |密码| 必要 | 开启时为4位，关闭时必须为空 |
25
| teenagers_mode | num |开启/关闭模式| 必要 | 0为开启，1为关闭 |
26
| teenagers_status | num |当前模式状态| 必要 | 0为已经开启，1为目前关闭 |
27
28
**json回复：**
29
30
根对象：
31
32
| 字段 | 类型 | 内容 | 备注 |
33
| ------- | ------ | -------- | ---------------------------- |
34
| code | num | 返回值 | 0：成功 <br />-400：请求错误 |
35
| message | str | 错误信息 | 默认为0 |
36
| ttl | num | 1 | |
37
38
**示例：**
39
关闭本账号的青少年模式（pwd=&teenagers_mode=1&teenagers_status=0）
40
```shell
41
curl --location 'https://app.bilibili.com/x/v2/account/teenagers/update' \
42
--header 'Device-Id: 你的设备id' \
43
--header 'Fp_local: 你的本地设备指纹' \
44
--header 'Fp_remote: 你的远程设备指纹' \
45
--header 'Session_id: 会话id' \
46
--header 'App-Key: android' \
47
--header 'Content-Type: application/x-www-form-urlencoded; charset=utf-8' \
48
--data-urlencode 'access_key=你的access_key' \
49
--data-urlencode 'appkey=1d8b6e7d45233436' \
50
--data-urlencode 'build=6270200' \
51
--data-urlencode 'c_locale=zh_CN' \
52
--data-urlencode 'channel=yingyongbao' \
53
--data-urlencode 'device_model=samsung%257CSM-G955N' \
54
--data-urlencode 'mobi_app=android' \
55
--data-urlencode 'platform=android' \
56
--data-urlencode 's_locale=zh_CN' \
57
--data-urlencode 'statistics=%257B%2522appId%2522%253A1%252C%2522platform%2522%253A3%252C%2522version%2522%253A%25226.27.0%2522%252C%2522abtest%2522%253A%2522%2522%257D' \
58
--data-urlencode 'pwd=' \
59
--data-urlencode 'teenagers_mode=1' \
60
--data-urlencode 'teenagers_status=0' \
61
--data-urlencode 'ts=1699301298' \
62
--data-urlencode 'sign=0666c38cb79691c4a0d9570a0669ec96' \
63
```
64
65
<details>
66
<summary>查看响应示例：</summary>
67
68
```json
69
{
70
"code": 0,
71
"message": "0",
72
"ttl": 1
73
}
74
```
75
pwd有数值时
76
```json
77
{
78
"code": -400,
79
"message": "关闭时密码必须为空",
80
"ttl": 1
81
}
82
```
83
84
</details>