From d0f6de0b4fde3d3cfed49b0a5c5bb423de140ab6 Mon Sep 17 00:00:00 2001
From: hd80606b <42578272+hd80606b@users.noreply.github.com>
Date: Fri, 12 Jan 2024 18:08:44 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E7=A7=81=E4=BF=A1=E6=B6=88?=
=?UTF-8?q?=E6=81=AF=E8=AE=B0=E5=BD=95=E5=8F=82=E6=95=B0=EF=BC=8C=E6=96=B0?=
=?UTF-8?q?=E5=A2=9E=E9=9D=92=E5=B0=91=E5=B9=B4=E6=A8=A1=E5=BC=8F=E6=8E=A5?=
=?UTF-8?q?=E5=8F=A3=20(#935)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
* Update private_msg.md
为私信消息记录添加新的参数
* Add teenager_mode
* Update teenager_mode.md
修正格式
* move teenager_mode.md to teenager
* add teenager
* Update teenager_mode.md
---
README.md | 4 ++
docs/message/private_msg.md | 4 +-
docs/teenager/teenager_mode.md | 84 ++++++++++++++++++++++++++++++++++
3 files changed, 91 insertions(+), 1 deletion(-)
create mode 100644 docs/teenager/teenager_mode.md
diff --git a/README.md b/README.md
index 8bf56da..37d14f7 100644
--- a/README.md
+++ b/README.md
@@ -239,6 +239,10 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
- [x] [查询信息](docs/newbie_exam/info.md)
- [x] [拉取题目](docs/newbie_exam/fetch.md)
- [x] [操作](docs/newbie_exam/action.md)
+- [ ] [青少年守护](docs/teenager/)
+ - [x] [青少年模式](docs/teenager/teenager_mode.md)
+ - [ ] 亲子平台
+ - [ ] 课堂模式
- [ ] B币钱包
- [ ] 基本信息
- [ ] B币充值
diff --git a/docs/message/private_msg.md b/docs/message/private_msg.md
index e0b9f9b..e3241f1 100644
--- a/docs/message/private_msg.md
+++ b/docs/message/private_msg.md
@@ -249,9 +249,11 @@ curl 'https://api.vc.bilibili.com/web_im/v1/web_im/send_msg' \
| sender_device_id | num | 发送者设备 | 可选 | 1 |
| talker_id | num | 聊天对象的UID | 必要 | -------------- |
| session_type | num | 聊天对象的类型 | 必要 | 1为用户，2为粉丝团 |
-| size | num | 列出消息条数 | 可选 | 默认是20 |
+| size | num | 列出消息条数 | 可选 | 默认是20，最大为200 |
| build | num | 未知 | 可选 | 默认是0 |
| mobi_app | str | 设备 | 可选 | web |
+| begin_seqno | num | 开始的序列号 | 可选 | 默认0为全部 |
+| end_seqno | num | 结束的序列号 | 可选 | 默认0为全部 |
**json回复：**
diff --git a/docs/teenager/teenager_mode.md b/docs/teenager/teenager_mode.md
new file mode 100644
index 0000000..6c3e85c
--- /dev/null
+++ b/docs/teenager/teenager_mode.md
@@ -0,0 +1,84 @@
+# 青少年模式
+## 开启/关闭
+> https://app.bilibili.com/x/v2/account/teenagers/update
+
+*请求方式：POST*
+
+认证方式：APP（详见[设备各类标识算法](docs/misc/device_identity.md)）
+
+**POST参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+|--------|-----|-------|---------|-----|
+| appkey | str | APP密钥 | APP必要 | |
+| ts | num | 当前时间戳 | APP必要 | |
+| sign | str | APP签名 | APP必要 | |
+| access_key | str | APP登录Token | APP必要 | |
+| device_model | str | 设备 Model | APP必要 | |
+| channel | str | APP下载渠道 | APP必要 | 比如yingyongbao |
+| mobi_app | str |APP 包类型 | APP必要 | |
+| platform | str |平台类型| APP必要 | android |
+| c_locale | str |语言| 非必要 | zh_CN |
+| s_locale | str |语言| 非必要 | zh_CN |
+| statistics | str | ? | 必要 | 一般固定为{"appId":1,"platform":3,"version":"7.27.0","abtest":""},非key-value入参需要转URL编码 |
+| pwd | num |密码| 必要 | 开启时为4位，关闭时必须为空 |
+| teenagers_mode | num |开启/关闭模式| 必要 | 0为开启，1为关闭 |
+| teenagers_status | num |当前模式状态| 必要 | 0为已经开启，1为目前关闭 |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ------ | -------- | ---------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误 |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+
+**示例：**
+关闭本账号的青少年模式（pwd=&teenagers_mode=1&teenagers_status=0）
+```shell
+curl --location 'https://app.bilibili.com/x/v2/account/teenagers/update' \
+--header 'Device-Id: 你的设备id' \
+--header 'Fp_local: 你的本地设备指纹' \
+--header 'Fp_remote: 你的远程设备指纹' \
+--header 'Session_id: 会话id' \
+--header 'App-Key: android' \
+--header 'Content-Type: application/x-www-form-urlencoded; charset=utf-8' \
+--data-urlencode 'access_key=你的access_key' \
+--data-urlencode 'appkey=1d8b6e7d45233436' \
+--data-urlencode 'build=6270200' \
+--data-urlencode 'c_locale=zh_CN' \
+--data-urlencode 'channel=yingyongbao' \
+--data-urlencode 'device_model=samsung%257CSM-G955N' \
+--data-urlencode 'mobi_app=android' \
+--data-urlencode 'platform=android' \
+--data-urlencode 's_locale=zh_CN' \
+--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' \
+--data-urlencode 'pwd=' \
+--data-urlencode 'teenagers_mode=1' \
+--data-urlencode 'teenagers_status=0' \
+--data-urlencode 'ts=1699301298' \
+--data-urlencode 'sign=0666c38cb79691c4a0d9570a0669ec96' \
+```
+
+
+查看响应示例：
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1
+}
+```
+pwd有数值时
+```json
+{
+ "code": -400,
+ "message": "关闭时密码必须为空",
+ "ttl": 1
+}
+```
+
+