返回提交历史
Modified
docs/message/settings.md
+76
-0
XFEstudio/bilibili-API-collect
feat(message/settings): #1267
11559a3
代码差异
1 个文件
+76
-0
@@ -97,6 +97,82 @@ curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/get' \
97
97
98
98
</details>
99
99
100
## 修改用户偏好设置
101
102
> <https://api.vc.bilibili.com/link_setting/v1/link_setting/set>
103
104
*请求方式：POST*
105
106
认证方式：Cookie（SESSDATA）
107
108
参数名称与值基本同「[获取用户偏好设置](#获取用户偏好设置)」中的 `data` 对象，修改设置时只需提供修改的设置对应的参数即可
109
110
开启自动回复功能需要 1000 粉丝及以上，否则会提示 700009 `权限不足`
111
112
**正文参数（application/x-www-form-urlencoded）：**
113
114
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
115
| ------------------------ | ---- | ------------------------ | ------ | ----------------------------------------------------- |
116
| show_unfollowed_msg | num | 收起未关注人消息 | 非必要 | 0：不收起<br />1：收起 |
117
| msg_notify | num | 消息提醒 | 非必要 | 1：接收<br />3：不接收 |
118
| set_like | num | 收到的赞提醒 | 非必要 | 0：接收<br />5：不接收 |
119
| set_comment | num | 回复我的提醒 | 非必要 | 0：所有人<br />1：关注的人<br />2：不接受任何消息提醒 |
120
| set_at | num | @ 我的提醒 | 非必要 | 0：所有人<br />1：关注的人<br />2：不接受任何消息提醒 |
121
| is_group_fold | num | 收起应援团消息 | 非必要 | 0：不收起<br />1：收起 |
122
| should_receive_group | num | 接收应援团消息 | 非必要 | 0：不接收<br />1：接收 |
123
| receive_unfollow_msg | num | 接收未关注人消息 | 非必要 | 0：不接收<br />1：接收 |
124
| followed_reply | num | 被关注回复 | 非必要 | 需要有自动回复权限<br />0：关闭<br />1：开启 |
125
| keys_reply | num | 关键词回复 | 非必要 | 需要有自动回复权限<br />0：关闭<br />1：开启 |
126
| recv_reply | num | 收到消息回复 | 非必要 | 需要有自动回复权限<br />0：关闭<br />1：开启 |
127
| voyage_reply | num | 大航海上船回复 | 非必要 | 需要有自动回复权限<br />0：关闭<br />1：开启 |
128
| recommend_followed_reply | num | 被关注时自动推送作品 | 非必要 | 需要有自动回复权限<br />0：关闭<br />1：开启 |
129
| ai_intercept | num | 私信智能拦截 | 非必要 | 0：关闭<br />1：开启 |
130
| build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
131
| mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
132
| csrf_token | str | CSRF Token（位于cookie） | 必要 | |
133
| csrf | str | CSRF Token（位于cookie） | 必要 | |
134
135
**json回复：**
136
137
根对象：
138
139
| 字段 | 类型 | 内容 | 备注 |
140
| ------- | ---- | -------- | --------------------------------------------------- |
141
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />700009：权限不足 |
142
| msg | str | 错误信息 | 默认为0 |
143
| message | str | 错误信息 | 默认为0 |
144
| ttl | num | 1 | |
145
| data | obj | 信息本体 | 空对象 |
146
147
**示例：**
148
149
开启接收消息提醒
150
151
```shell
152
curl 'https://api.vc.bilibili.com/link_setting/v1/link_setting/set' \
153
--data-urlencode 'msg_notify=1' \
154
--data-urlencode 'build=0' \
155
--data-urlencode 'mobi_app=web' \
156
--data-urlencode 'csrf_token=xxx' \
157
--data-urlencode 'csrf=xxx' \
158
-b 'SESSDATA=xxx'
159
```
160
161
<details>
162
<summary>查看响应示例：</summary>
163
164
```json
165
{
166
"code": 0,
167
"msg": "0",
168
"message": "0",
169
"ttl": 1,
170
"data": {}
171
}
172
```
173
174
</details>
175
100
176
## 获取系统设置
101
177
102
178
> <https://api.vc.bilibili.com/link_setting/v1/link_setting/get_sys_setting>