新增私信消息记录参数,新增青少年模式接口 (#935)

* Update private_msg.md

为私信消息记录添加新的参数

* Add teenager_mode

* Update teenager_mode.md

修正格式

* move teenager_mode.md to teenager

* add teenager

* Update teenager_mode.md
This commit is contained in:
hd80606b 2024-01-12 18:08:44 +08:00 committed by GitHub
parent 180b8ce908
commit d0f6de0b4f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 91 additions and 1 deletions

View File

@ -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币充值

View File

@ -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回复**

View File

@ -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成功 <br />-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' \
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
pwd有数值时
```json
{
"code": -400,
"message": "关闭时密码必须为空",
"ttl": 1
}
```
</details>