XFE Git
XFE Studio Git
Git 首页 全局搜索
XFE 主站 文档 NuGet
公开
关注 0 Fork 0 Star 0
返回提交历史

XFEstudio/bilibili-API-collect

feat(private_msg): get msg dnd & intercept

Signed-off-by: 晨叶梦春 <65224318+wuziqian211@users.noreply.github.com>

1c5a070
晨叶梦春 <65224318+wuziqian211@users.noreply.github.com>
提交于
父提交 73c4973

代码差异

1 个文件 +394 -82
Modified docs/message/private_msg.md +394 -82
@@ -55,7 +55,7 @@
55 55 | msg_seqno | num | 消息序列号 | 按照时间顺序从小到大 |
56 56 | timestamp | num | 消息发送时间 | 秒级时间戳 |
57 57 | at_uids | 有效时：array<br />无效时：null | at的成员mid | 在粉丝团时有效；此项为 `null` 或 `[0]` 均表示没有 at 成员 |
58 | msg_key | num | 消息唯一id | 部分库在解析JSON对象中的大数时存在数值的精度丢失问题，因此在处理私信时可能会出现问题，建议使用修复了这一问题的库（如将大数转换成文本） |
58 | msg_key | num | 消息唯一id | 部分库在解析JSON对象中的大数时存在数值的精度丢失问题，因此在处理此字段时可能会出现问题，建议使用修复了这一问题的库（如将大数转换成文本） |
59 59 | msg_status | num | 消息状态 | 0：正常<br />1：被撤回（接口仍能返回被撤回的私信内容）<br />2：被系统撤回（如：消息被举报；私信将不会显示在前端，B站接口也不会返回被系统撤回的私信的信息）<br />50：图片已失效（私信内容为一张提示“图片出现问题”的图片） |
60 60 | sys_cancel | bool | 是否为系统撤回 | 仅当 `msg_type` 为 `5` 且此项值为 `true` 时有此项；若此项值为 `true`，表示目标消息是被系统撤回的，此时前端将不显示该私信且没有提示 |
61 61 | notify_code | str | 通知代码 | 发送通知时使用，以下划线 `_` 分割，第 1 项表示主业务 id，第 2 项表示子业务 id；若这条私信非通知则为空文本；详细信息有待补充 |
@@ -103,7 +103,7 @@
103 103
104 104 认证方式：Cookie（SESSDATA）
105 105
106 注: 该接口默认每 2 分钟请求一次
106 注: 该接口默认每 2 分钟请求一次；该接口不会返回[未读粉丝团私信数](#获取未读粉丝团私信数)
107 107
108 108 **URL参数:**
109 109
@@ -178,6 +178,67 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
178 178
179 179 </details>
180 180
181 ### 获取未读粉丝团私信数
182
183 > <https://api.vc.bilibili.com/session_svr/v1/session_svr/my_group_unread>
184
185 *请求方式：GET*
186
187 认证方式：Cookie（SESSDATA）
188
189 **url参数：**
190
191 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
192 | -------- | ---- | ---------------- | ------ | ------------- |
193 | build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
194 | mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
195
196 **json回复：**
197
198 根对象：
199
200 | 字段 | 类型 | 内容 | 备注 |
201 | ------- | ---- | -------- | ----------------------------- |
202 | code | num | 返回值 | 0：成功<br />-101：账号未登录 |
203 | msg | str | 错误信息 | 默认为0 |
204 | message | str | 错误信息 | 默认为0 |
205 | ttl | num | 1 | |
206 | data | obj | 信息本体 | |
207
208 `data` 对象：
209
210 | 字段 | 类型 | 内容 | 备注 |
211 | ------------ | ---- | ---------------- | ---------------- |
212 | unread_count | num | 未读粉丝团私信数 | |
213
214 **示例：**
215
216 以下信息代表未读粉丝团私信数为 `497` 条
217
218 ```shell
219 curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/my_group_unread' \
220 --data-urlencode 'build=0' \
221 --data-urlencode 'mobi_app=web' \
222 -b 'SESSDATA=xxx'
223 ```
224
225 <details>
226 <summary>查看响应示例：</summary>
227
228 ```json
229 {
230 "code": 0,
231 "msg": "0",
232 "message": "0",
233 "ttl": 1,
234 "data": {
235 "unread_count": 497
236 }
237 }
238 ```
239
240 </details>
241
181 242 ### 获取指定类型会话列表
182 243
183 244 > <https://api.vc.bilibili.com/session_svr/v1/session_svr/get_sessions>
@@ -190,10 +251,10 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
190 251
191 252 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
192 253 | ------------- | ---- | -------------------- | ------ | ------------------------- |
193 | session_type | num | 会话类型 | 必要 | 1：未被折叠<br />2：未关注人<br />3：粉丝团<br />4：所有<br />5：被拦截<br />7：系统消息（？） |
254 | session_type | num | 会话类型 | 必要 | 1：用户与系统<br />2：未关注人<br />3：粉丝团<br />4：所有<br />5：被拦截<br />6：花火商单<br />7：所有系统消息<br />8：陌生人（与 “未关注人” 不同，不包含官方消息）<br />9：关注的人与系统 |
194 255 | group_fold | num | 是否折叠粉丝团消息 | 非必要 | 0：否<br />1：是 |
195 256 | unfollow_fold | num | 是否折叠未关注人消息 | 非必要 | 0：否<br />1：是 |
196 | sort_rule | num | 排序方式 | 非必要 | 1、2：按会话时间逆向排序<br />3：按已读时间逆向排序<br />其他：用户按会话时间逆向排序，粉丝团按加群时间正向排序（？） |
257 | sort_rule | num | 排序方式 | 非必要 | 仅当 `session_type` 不为 `4`、`7` 时有效<br />1、2：按会话时间逆向排序<br />3：按已读时间逆向排序<br />其他：用户与系统按会话时间逆向排序，粉丝团按加群时间正向排序 |
197 258 | begin_ts | num | 起始时间 | 非必要 | 微秒级时间戳 |
198 259 | end_ts | num | 终止时间 | 非必要 | 微秒级时间戳 |
199 260 | size | num | 返回的会话数 | 非必要 | 默认为 `20`，最大为 `100` |
@@ -204,13 +265,13 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \
204 265
205 266 根对象：
206 267
207 | 字段 | 类型 | 内容 | 备注 |
208 | ------- | ---- | -------- | ------------------------------------------------- |
209 | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
210 | msg | str | 错误信息 | 默认为0 |
211 | message | str | 错误信息 | 默认为0 |
212 | ttl | num | 1 | |
213 | data | obj | 数据本体 | |
268 | 字段 | 类型 | 内容 | 备注 |
269 | ------- | ---- | -------- | ------------------------------------------------------------------ |
270 | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />2：非法参数 |
271 | msg | str | 错误信息 | 默认为0 |
272 | message | str | 错误信息 | 默认为0 |
273 | ttl | num | 1 | |
274 | data | obj | 数据本体 | |
214 275
215 276 `data`对象：
216 277
@@ -787,6 +848,96 @@ curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/is_limit' \
787 848
788 849 </details>
789 850
851 ### 获取会话免打扰状态
852
853 > <https://api.vc.bilibili.com/link_setting/v1/link_setting/get_msg_dnd>
854
855 *请求方式：GET*
856
857 认证方式：Cookie（SESSDATA）
858
859 仅支持用户会话
860
861 **url参数：**
862
863 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
864 | --------- | ---- | ---------------- | ------ | ----------------------- |
865 | own_uid | num | 自己的mid | 必要 | |
866 | uids | num | 用户mid | 非必要 | 仅支持填入 **1 个** mid |
867 | group_ids | num | 粉丝团id | 非必要 | 仅支持填入 **1 个** id |
868 | build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
869 | mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
870
871 **json回复：**
872
873 根对象：
874
875 | 字段 | 类型 | 内容 | 备注 |
876 | ------- | ---- | -------- | ------------------------------------------------- |
877 | code | num | 返回值 | 0：成功<br />2：非法参数<br />-101：账号未登录<br />-400：请求错误 |
878 | msg | str | 错误信息 | 默认为0 |
879 | message | str | 错误信息 | 默认为0 |
880 | ttl | num | 1 | |
881 | data | obj | 数据本体 | |
882
883 `data`对象：
884
885 | 字段 | 类型 | 内容 | 备注 |
886 | -------------- | ----- | ---------------- | ------------------------------------- |
887 | uid_settings | array | 用户免打扰状态 | 仅当请求参数 `uids` 存在时有此项 |
888 | group_settings | array | 粉丝团免打扰状态 | 仅当请求参数 `group_ids` 存在时有此项 |
889
890 `data`对象中的`uid_settings`、`group_settings`数组：
891
892 | 项 | 类型 | 内容 | 备注 |
893 | ---- | ---- | -------------- | --------------------------------- |
894 | 0 | obj | 会话免打扰状态 | 仅有1项 |
895
896 `uid_settings`、`group_settings`数组中的对象：
897
898 | 字段 | 类型 | 内容 | 备注 |
899 | ------- | ---- | ----------------- | -------------------------------- |
900 | id | num | 用户mid或粉丝团id | |
901 | setting | num | 免打扰状态 | 0：关闭免打扰<br />1：开启免打扰 |
902
903 **示例：**
904
905 获取会话`uids=2`与`group_ids=221082140`的免打扰状态：
906
907 ```shell
908 curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/get_msg_dnd' \
909 --data-urlencode 'own_uid=425503913' \
910 --data-urlencode 'uids=2' \
911 --data-urlencode 'group_ids=221082140' \
912 --data-urlencode 'build=0' \
913 --data-urlencode 'mobi_app=web' \
914 -b 'SESSDATA=xxx'
915 ```
916
917 <details>
918 <summary>查看响应示例：</summary>
919
920 ```json
921 {
922 "code": 0,
923 "msg": "0",
924 "message": "0",
925 "ttl": 1,
926 "data": {
927 "uid_settings": [{
928 "id": 2,
929 "setting": 0
930 }],
931 "group_settings": [{
932 "id": 221082140,
933 "setting": 0
934 }]
935 }
936 }
937 ```
938
939 </details>
940
790 941 ### 获取会话推送设置
791 942
792 943 > <https://api.vc.bilibili.com/link_setting/v1/link_setting/get_session_ss>
@@ -858,21 +1009,23 @@ curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/get_session_ss
858 1009
859 1010 </details>
860 1011
861 ### 修改会话置顶状态
1012 ### 设置会话为已读
862 1013
863 > <https://api.vc.bilibili.com/session_svr/v1/session_svr/set_top>
1014 > <https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack>
864 1015
865 1016 *请求方式：POST*
866 1017
867 1018 认证方式：Cookie（SESSDATA）
868 1019
1020 将指定会话中的指定消息及以前的消息设置为已读
1021
869 1022 **正文参数（application/x-www-form-urlencoded）：**
870 1023
871 1024 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
872 1025 | ------------ | ---- | ------------------------ | ------ | ---------------------------------------------------- |
873 1026 | talker_id | num | 聊天对象的id | 必要 | `session_type` 为 `1` 时表示用户 mid，为 `2` 时表示粉丝团 id |
874 1027 | session_type | num | 聊天对象的类型 | 必要 | 1：用户<br />2：粉丝团 |
875 | op_type | num | 操作类型 | 必要 | 0：置顶<br />1：取消置顶 |
1028 | ack_seqno | num | 设置为已读的消息序列号 | 非必要 | 留空表示最新的消息 |
876 1029 | csrf_token | str | CSRF Token（位于cookie） | 必要 | |
877 1030 | csrf | str | CSRF Token（位于cookie） | 必要 | |
878 1031 | build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
@@ -892,13 +1045,13 @@ curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/get_session_ss
892 1045
893 1046 **示例：**
894 1047
895 置顶会话`talker_id=293793435&session_type=1`
1048 将`talker_id=293793435`、`session_type=1`的`ack_seqno=1236306587877408`消息及之前的消息设置为已读
896 1049
897 1050 ```shell
898 curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/set_top' \
899 --data-urlencode 'talker_id=2' \
1051 curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack' \
1052 --data-urlencode 'talker_id=293793435' \
900 1053 --data-urlencode 'session_type=1' \
901 --data-urlencode 'op_type=0' \
1054 --data-urlencode 'ack_seqno=1236306587877408' \
902 1055 --data-urlencode 'csrf=xxx' \
903 1056 --data-urlencode 'csrf_token=xxx' \
904 1057 -b 'SESSDATA=xxx'
@@ -980,6 +1133,67 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/remove_session' \
980 1133
981 1134 </details>
982 1135
1136 ### 修改会话置顶状态
1137
1138 > <https://api.vc.bilibili.com/session_svr/v1/session_svr/set_top>
1139
1140 *请求方式：POST*
1141
1142 认证方式：Cookie（SESSDATA）
1143
1144 **正文参数（application/x-www-form-urlencoded）：**
1145
1146 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
1147 | ------------ | ---- | ------------------------ | ------ | ---------------------------------------------------- |
1148 | talker_id | num | 聊天对象的id | 必要 | `session_type` 为 `1` 时表示用户 mid，为 `2` 时表示粉丝团 id |
1149 | session_type | num | 聊天对象的类型 | 必要 | 1：用户<br />2：粉丝团 |
1150 | op_type | num | 操作类型 | 必要 | 0：置顶<br />1：取消置顶 |
1151 | csrf_token | str | CSRF Token（位于cookie） | 必要 | |
1152 | csrf | str | CSRF Token（位于cookie） | 必要 | |
1153 | build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
1154 | mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
1155
1156 **json回复：**
1157
1158 根对象：
1159
1160 | 字段 | 类型 | 内容 | 备注 |
1161 | ------- | ---- | -------- | ------------------------------------------------- |
1162 | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
1163 | msg | str | 错误信息 | 成功时为0 |
1164 | message | str | 错误信息 | 成功时为0 |
1165 | ttl | num | | 默认为1 |
1166 | data | 有效时：obj<br />无效时：不存在该项 | 信息本体 | 空对象 |
1167
1168 **示例：**
1169
1170 置顶会话`talker_id=293793435&session_type=1`
1171
1172 ```shell
1173 curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/set_top' \
1174 --data-urlencode 'talker_id=2' \
1175 --data-urlencode 'session_type=1' \
1176 --data-urlencode 'op_type=0' \
1177 --data-urlencode 'csrf=xxx' \
1178 --data-urlencode 'csrf_token=xxx' \
1179 -b 'SESSDATA=xxx'
1180 ```
1181
1182 <details>
1183 <summary>查看响应示例：</summary>
1184
1185 ```json
1186 {
1187 "code": 0,
1188 "msg": "0",
1189 "message": "0",
1190 "ttl": 1,
1191 "data": {}
1192 }
1193 ```
1194
1195 </details>
1196
983 1197 ### 修改会话免打扰状态
984 1198
985 1199 > <https://api.vc.bilibili.com/link_setting/v1/link_setting/set_msg_dnd>
@@ -1103,6 +1317,167 @@ curl 'https://api.vc.bilibili.com/link_setting/v1/link_setting/set_push_ss' \
1103 1317
1104 1318 </details>
1105 1319
1320 ### 修改会话拦截状态
1321
1322 > <https://api.vc.bilibili.com/session_svr/v1/session_svr/update_intercept>
1323
1324 *请求方式：POST*
1325
1326 认证方式：Cookie（SESSDATA）
1327
1328 仅支持用户会话
1329
1330 **正文参数（application/x-www-form-urlencoded）：**
1331
1332 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
1333 | ---------- | ---- | ------------------------ | ------ | ---------------------------- |
1334 | talker_id | num | 聊天对象mid | 必要 | |
1335 | status | num | 拦截状态 | 必要 | 0：取消拦截<br />1：设置拦截 |
1336 | csrf_token | str | CSRF Token（位于cookie） | 必要 | |
1337 | csrf | str | CSRF Token（位于cookie） | 必要 | |
1338 | build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
1339 | mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
1340
1341 **json回复：**
1342
1343 根对象：
1344
1345 | 字段 | 类型 | 内容 | 备注 |
1346 | ------- | ---- | -------- | ------------------------------------------------- |
1347 | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
1348 | msg | str | 错误信息 | 成功时为0 |
1349 | message | str | 错误信息 | 成功时为0 |
1350 | ttl | num | | 默认为1 |
1351 | data | 有效时：obj<br />无效时：不存在该项 | 信息本体 | 空对象 |
1352
1353 **示例：**
1354
1355 对会话`talker_id=2`取消拦截状态
1356
1357 ```shell
1358 curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/update_intercept' \
1359 --data-urlencode 'talker_id=2' \
1360 --data-urlencode 'status=0' \
1361 --data-urlencode 'csrf=xxx' \
1362 --data-urlencode 'csrf_token=xxx' \
1363 -b 'SESSDATA=xxx'
1364 ```
1365
1366 <details>
1367 <summary>查看响应示例：</summary>
1368
1369 ```json
1370 {
1371 "code": 0,
1372 "msg": "0",
1373 "message": "0",
1374 "ttl": 1,
1375 "data": {}
1376 }
1377 ```
1378
1379 ### 设置所有拦截会话为已读
1380
1381 > <https://api.vc.bilibili.com/session_svr/v1/session_svr/batch_update_dustbin_ack>
1382
1383 *请求方式：POST*
1384
1385 认证方式：Cookie（SESSDATA）
1386
1387 **正文参数（application/x-www-form-urlencoded）：**
1388
1389 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
1390 | ---------- | ---- | ------------------------ | ------ | ------------- |
1391 | csrf_token | str | CSRF Token（位于cookie） | 必要 | |
1392 | csrf | str | CSRF Token（位于cookie） | 必要 | |
1393 | build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
1394 | mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
1395
1396 **json回复：**
1397
1398 根对象：
1399
1400 | 字段 | 类型 | 内容 | 备注 |
1401 | ------- | ---- | -------- | ------------------------------------------------- |
1402 | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
1403 | msg | str | 错误信息 | 成功时为0 |
1404 | message | str | 错误信息 | 成功时为0 |
1405 | ttl | num | | 默认为1 |
1406 | data | 有效时：obj<br />无效时：不存在该项 | 信息本体 | 空对象 |
1407
1408 **示例：**
1409
1410 ```shell
1411 curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/batch_update_dustbin_ack' \
1412 --data-urlencode 'csrf=xxx' \
1413 --data-urlencode 'csrf_token=xxx' \
1414 -b 'SESSDATA=xxx'
1415 ```
1416
1417 <details>
1418 <summary>查看响应示例：</summary>
1419
1420 ```json
1421 {
1422 "code": 0,
1423 "msg": "0",
1424 "message": "0",
1425 "ttl": 1,
1426 "data": {}
1427 }
1428 ```
1429
1430 ### 移除所有拦截会话
1431
1432 > <https://api.vc.bilibili.com/session_svr/v1/session_svr/batch_rm_dustbin>
1433
1434 *请求方式：POST*
1435
1436 认证方式：Cookie（SESSDATA）
1437
1438 **正文参数（application/x-www-form-urlencoded）：**
1439
1440 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
1441 | ---------- | ---- | ------------------------ | ------ | ------------- |
1442 | csrf_token | str | CSRF Token（位于cookie） | 必要 | |
1443 | csrf | str | CSRF Token（位于cookie） | 必要 | |
1444 | build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
1445 | mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
1446
1447 **json回复：**
1448
1449 根对象：
1450
1451 | 字段 | 类型 | 内容 | 备注 |
1452 | ------- | ---- | -------- | ------------------------------------------------- |
1453 | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
1454 | msg | str | 错误信息 | 成功时为0 |
1455 | message | str | 错误信息 | 成功时为0 |
1456 | ttl | num | | 默认为1 |
1457 | data | 有效时：obj<br />无效时：不存在该项 | 信息本体 | 空对象 |
1458
1459 **示例：**
1460
1461 ```shell
1462 curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/batch_rm_dustbin' \
1463 --data-urlencode 'csrf=xxx' \
1464 --data-urlencode 'csrf_token=xxx' \
1465 -b 'SESSDATA=xxx'
1466 ```
1467
1468 <details>
1469 <summary>查看响应示例：</summary>
1470
1471 ```json
1472 {
1473 "code": 0,
1474 "msg": "0",
1475 "message": "0",
1476 "ttl": 1,
1477 "data": {}
1478 }
1479 ```
1480
1106 1481 ## 私信消息相关
1107 1482
1108 1483 ### 查询私信消息记录
@@ -1113,7 +1488,7 @@ curl 'https://api.vc.bilibili.com/link_setting/v1/link_setting/set_push_ss' \
1113 1488
1114 1489 认证方式：Cookie（SESSDATA）
1115 1490
1116 仅调用该接口不会设置私信为已读，详见[设置私信为已读](#设置私信为已读)
1491 仅调用该接口不会设置会话为已读，详见[设置会话为已读](#设置会话为已读)
1117 1492
1118 1493 此接口有设计缺陷，可以获取已经撤回（`msg_status` 为 `1`）的私信内容
1119 1494
@@ -1427,69 +1802,6 @@ curl -G 'https://api.vc.bilibili.com/x/im/feed/infoweb' \
1427 1802
1428 1803 </details>
1429 1804
1430 ### 设置私信为已读
1431
1432 > <https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack>
1433
1434 *请求方式：POST*
1435
1436 认证方式：Cookie（SESSDATA）
1437
1438 将指定会话中的指定消息及以前的消息设置为已读
1439
1440 **正文参数（application/x-www-form-urlencoded）：**
1441
1442 | 参数名 | 类型 | 内容 | 必要性 | 备注 |
1443 | ------------ | ---- | ------------------------ | ------ | ---------------------------------------------------- |
1444 | talker_id | num | 聊天对象的id | 必要 | `session_type` 为 `1` 时表示用户 mid，为 `2` 时表示粉丝团 id |
1445 | session_type | num | 聊天对象的类型 | 必要 | 1：用户<br />2：粉丝团 |
1446 | ack_seqno | num | 设置为已读的消息序列号 | 必要 | |
1447 | csrf_token | str | CSRF Token（位于cookie） | 必要 | |
1448 | csrf | str | CSRF Token（位于cookie） | 必要 | |
1449 | build | num | 客户端内部版本号 | 非必要 | 默认为 `0` |
1450 | mobi_app | str | 平台标识 | 非必要 | 可为 `web` 等 |
1451
1452 **json回复：**
1453
1454 根对象：
1455
1456 | 字段 | 类型 | 内容 | 备注 |
1457 | ------- | ---- | -------- | ------------------------------------------------- |
1458 | code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
1459 | msg | str | 错误信息 | 成功时为0 |
1460 | message | str | 错误信息 | 成功时为0 |
1461 | ttl | num | | 默认为1 |
1462 | data | 有效时：obj<br />无效时：不存在该项 | 信息本体 | 空对象 |
1463
1464 **示例：**
1465
1466 将`talker_id=293793435`、`session_type=1`的`ack_seqno=1236306587877408`消息及之前的消息设置为已读
1467
1468 ```shell
1469 curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack' \
1470 --data-urlencode 'talker_id=293793435' \
1471 --data-urlencode 'session_type=1' \
1472 --data-urlencode 'ack_seqno=1236306587877408' \
1473 --data-urlencode 'csrf=xxx' \
1474 --data-urlencode 'csrf_token=xxx' \
1475 -b 'SESSDATA=xxx'
1476 ```
1477
1478 <details>
1479 <summary>查看响应示例：</summary>
1480
1481 ```json
1482 {
1483 "code": 0,
1484 "msg": "0",
1485 "message": "0",
1486 "ttl": 1,
1487 "data": {}
1488 }
1489 ```
1490
1491 </details>
1492
1493 1805 ### 发送私信（web端）
1494 1806
1495 1807 > <https://api.vc.bilibili.com/web_im/v1/web_im/send_msg>