From b8da0e5b18258c79ac69088552a4aa86a4dead2f Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Sat, 16 Mar 2024 03:32:52 +0800 Subject: [PATCH] update --- docs/message/private_msg.md | 34 +++---- docs/message/private_msg_content.md | 132 +++++++++++++++++++++++----- docs/user/info.md | 2 +- docs/user/relation.md | 2 +- 4 files changed, 128 insertions(+), 42 deletions(-) diff --git a/docs/message/private_msg.md b/docs/message/private_msg.md index f88f238..811375f 100644 --- a/docs/message/private_msg.md +++ b/docs/message/private_msg.md @@ -10,21 +10,22 @@ 注：私信主体对象≠[私信内容对象](private_msg_content.md) -| 字段 | 类型 | 内容 | 备注 | -| ---------------- | ---- | ------------------ | -------------------------------------------------------------- | -| sender_uid | num | 发送者mid | | -| receiver_type | num | 接收者类型 | 1：用户
2：粉丝团 | -| receiver_id | num | 接收者id | `receiver_type` 为 `1` 时表示用户 mid，为 `2` 时表示应援团 id | -| msg_type | num | 消息类型 | 详见[私信消息类型、内容说明](private_msg_content.md) | -| content | str | 消息内容 | [私信内容对象](private_msg_content.md)经过 JSON 序列化后的文本 | -| msg_seqno | num | 消息序列号 | 按照时间顺序从小到大 | -| timestamp | num | 消息发送秒级时间戳 | | -| at_uids | 有效时：array
无效时：null | at的成员mid | 在粉丝团时有效；此项为 `null` 或 `[0]` 均表示没有 at 成员 | -| msg_key | num | 消息唯一id | 部分库在解析JSON对象中的大数时存在数值的精度丢失问题，因此在处理私信时可能会出现问题，建议使用修复了这一问题的库（如将大数转换成文本） | -| msg_status | num | 消息状态 | 0：正常
1：被撤回（接口仍能返回被撤回的私信内容）
2：被系统撤回（私信将不会显示在前端，B站接口也不会返回被系统撤回的私信）
51：（？） | -| notify_code | str | 通知代码 | 发送通知时使用，以下划线 `_` 分割，第 1 项表示主业务 id，第 2 项表示子业务 id；若这条私信非通知则为空文本；详细信息有待补充 | -| new_face_version | num | 表情包版本 | 为 `0` 或无此项表示旧版表情包，此时 B 站会自动转换成新版表情包，例如 `[doge]` -> `[tv_doge]`；`1` 为新版 | -| msg_source | num | 消息来源 | 见[消息来源列表](#消息来源列表) | +| 字段 | 类型 | 内容 | 备注 | +| ---------------- | ---- | -------------- | -------------------------------------------------------------- | +| sender_uid | num | 发送者mid | | +| receiver_type | num | 接收者类型 | 1：用户
2：粉丝团 | +| receiver_id | num | 接收者id | `receiver_type` 为 `1` 时表示用户 mid，为 `2` 时表示应援团 id | +| msg_type | num | 消息类型 | 详见[私信消息类型、内容说明](private_msg_content.md) | +| content | str | 消息内容 | [私信内容对象](private_msg_content.md)经过 JSON 序列化后的文本 | +| msg_seqno | num | 消息序列号 | 按照时间顺序从小到大 | +| timestamp | num | 消息发送时间 | 秒级时间戳 | +| at_uids | 有效时：array
无效时：null | at的成员mid | 在粉丝团时有效；此项为 `null` 或 `[0]` 均表示没有 at 成员 | +| msg_key | num | 消息唯一id | 部分库在解析JSON对象中的大数时存在数值的精度丢失问题，因此在处理私信时可能会出现问题，建议使用修复了这一问题的库（如将大数转换成文本） | +| msg_status | num | 消息状态 | 0：正常
1：被撤回（接口仍能返回被撤回的私信内容）
2：被系统撤回（私信将不会显示在前端，B站接口也不会返回被系统撤回的私信）
50：图片已失效（私信内容为一张提示“图片出现问题”的图片） | +| sys_cancel | bool | 是否为系统撤回 | 仅当消息类型为 `5` 且此项值为 `true` 时有此项；若此项值为 `true`，表示目标消息是被系统撤回的 | +| notify_code | str | 通知代码 | 发送通知时使用，以下划线 `_` 分割，第 1 项表示主业务 id，第 2 项表示子业务 id；若这条私信非通知则为空文本；详细信息有待补充 | +| new_face_version | num | 表情包版本 | 为 `0` 或无此项表示旧版表情包，此时 B 站会自动转换成新版表情包，例如 `[doge]` -> `[tv_doge]`；`1` 为新版 | +| msg_source | num | 消息来源 | 见[消息来源列表](#消息来源列表) | `私信主体对象`中的`at_uids`数组： @@ -52,6 +53,7 @@ | 11 | 自动回复 - 大航海上船回复 | | | 12 | 自动推送 - UP 主赠言 | 在以前稿件的自动推送与其附带的 UP 主赠言是 2 条不同的私信（其中 UP 主赠言的消息来源代码为 12），现在 UP 主赠言已被合并成为稿件自动推送的一部分 | | 13 | 应援团系统提示 | 如：应援团中的提示信息“欢迎xxx入群” | +| 16 | （？） | **作用尚不明确** | | 17 | 互相关注 | 互相关注时自动发送的私信“我们已互相关注，开始聊天吧~” | | 18 | 系统提示 | 如：“对方主动回复或关注你前，最多发送1条消息” | | 19 | AI | 如：给[搜索AI助手测试版](https://space.bilibili.com/1400565964/)发送私信时对方的自动回复 | @@ -352,7 +354,7 @@ public class Main { | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------- | -| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误
10005：msgkey不存在
21007：消息过长，无法发送
21026：不能给自己发送消息哦~
21035：该类消息暂时无法发送
21037：图片格式不合法，不要调戏接口啦
21041：消息已超期，不能撤回了哦
21042：消息已经撤回了哦
21046：你发消息的频率太高了，请在24小时后再发吧~
21047：对方主动回复或关注你前，最多发送1条消息~ | +| code | num | 返回值 | 0：成功
-101：账号未登录
-400：请求错误
10005：msgkey不存在
21007：消息过长，无法发送
21026：不能给自己发送消息哦~
21035：该类消息暂时无法发送
21037：图片格式不合法，不要调戏接口啦
21041：消息已超期，不能撤回了哦
21042：消息已经撤回了哦
21046：你发消息的频率太高了，请在24小时后再发吧~
21047：对方主动回复或关注你前，最多发送1条消息~
25003：因对方隐私设置，暂无法给他发送聊天消息
25005：你已拉黑了对方，请先将对方移出黑名单后才能聊天 | | message | str | 错误信息 | 成功时为0 | | ttl | num | | 默认为1 | | data | 有效时：obj
无效时：null | 信息本体 | | diff --git a/docs/message/private_msg_content.md b/docs/message/private_msg_content.md index 87a8190..fb7640f 100644 --- a/docs/message/private_msg_content.md +++ b/docs/message/private_msg_content.md @@ -72,6 +72,34 @@ ## 分享消息（`msg_type=7`） +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ---------------- | -------------------------------------------------------------- | +| author | str | 分享内容作者 | 此项不实时更新，在发送私信时设置（非必要） | +| headline | str | 分享内容主标题 | 比 `title` 更突出；此项不实时更新，在发送私信时设置（非必要） | +| id | num | 分享内容id | | +| source | num | 分享内容类型 | ~~1：小视频~~（已弃用）
2：相簿
3：纯文字
4：直播
5：视频
6：专栏
7：番剧（`id` 为 season_id）
8：音乐
9：国产动画（`id` 为 AV 号）
10：图片
11：动态
16：番剧（`id` 为 epid）
17：番剧 | +| source_desc | str | 分享内容类型说明 | 仅当 `source` 值为 `16` 时有此项 | +| thumb | str | 分享内容封面 | 此项不实时更新，在发送私信时设置 | +| title | str | 分享内容标题 | 此项不实时更新，在发送私信时设置 | +| url | str | 分享内容url | （非必要） | +| bvid | str | 视频BV号 | （非必要） | + +**示例：** + +```json +{ + "author": "社会易姐QwQ", + "headline": "", + "id": 246551172, + "source": 5, + "thumb": "http://i2.hdslb.com/bfs/archive/14ba78056f946ece8c954a10677ef6b073edb178.jpg", + "title": "合 成 大 東 瓜", + "bvid": "BV16v411e7CW" +} +``` + ## 小程序消息（`msg_type=9`） 待补充 @@ -107,20 +135,16 @@ "text": "你预约的直播已开始，快来围观吧~", "jump_text": "进入直播间", "jump_uri": "https://live.bilibili.com/22747055?broadcast_type=0&is_room_feed=1&live_from=27040", - "modules": [ - { - "title": "预约主题", - "detail": "2024哔哩哔哩拜年纪" - }, - { - "title": "开播时间", - "detail": "2024-02-09 19:32" - }, - { - "title": "UP主", - "detail": "哔哩哔哩拜年纪" - } - ], + "modules": [{ + "title": "预约主题", + "detail": "2024哔哩哔哩拜年纪" + }, { + "title": "开播时间", + "detail": "2024-02-09 19:32" + }, { + "title": "UP主", + "detail": "哔哩哔哩拜年纪" + }], "jump_text_2": "", "jump_uri_2": "", "jump_text_3": "", @@ -231,28 +255,88 @@ 此类型消息仅可接收，不可直接发送 +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ------------------- | -------------------- | +| pic_url | str | 图片url | | +| jump_url | str | 点击图片跳转到的url | | +| title | str | 文字说明 | 显示在聊天列表的文字 | + +**示例：** + +```json +{ + "pic_url": "http://i0.hdslb.com/bfs/location/9e57aff7245c226c05ba46ddd1e82667f74d5a06.png", + "jump_url": "https://www.bilibili.com/h5/mall/suit/detail?navhide=1&id=66359&from=Banner", + "title": "原神，启动！" +} +``` ## 被关注时的自动推送消息（`msg_type=16`） +**示例：** + +```json +{ + "main_title": "更多宝藏内容", + "reply_content": "感谢大佬关注哦～[doge][脱单doge][doge]\n这里是科技区底边小UP，日常瞎折腾，软硬件电路程序网络服务器都折腾，视频月更风格硬核略小众，咕咕咕.....\n老大二了，就不中二了\n有什么好的建议欢迎私信", + "sub_cards": [{ + "card_id": 379743801, + "card_type": 1, + "jump_url": "https://b23.tv/BV1hZ4y197Cz", + "cover_url": "http://i2.hdslb.com/bfs/archive/bfb87f033272926efe6ff4caee8e6c49c07ff6fe.jpg", + "field1": "【宿舍评测】性能与便携两全 华为matebook E 2022深度体验及伪开箱", + "field2": "2021-12-10", + "field3": "195299", + "icon3": 1, + "field4": "479", + "icon4": 3 + }, { + "card_id": 768716232, + "card_type": 1, + "jump_url": "https://b23.tv/BV13r4y187R8", + "cover_url": "http://i1.hdslb.com/bfs/archive/bb1d41ef0c17c2df25c8b6ef98f01466bdee0c1f.jpg", + "field1": "【BadApple】使用古董示波器Aron BS-601播放BadApple!!!", + "field2": "2022-05-03", + "field3": "151613", + "icon3": 1, + "field4": "297", + "icon4": 3 + }, { + "card_id": 524989935, + "card_type": 1, + "jump_url": "https://b23.tv/BV17M411E7Kq", + "cover_url": "http://i1.hdslb.com/bfs/archive/17335854dfad9d7990943d8cc6dc07c85912b103.jpg", + "field1": "【拆解】华为 Matebook E 更换固态硬盘：从未见过如此好拆的二合一", + "field2": "2023-02-24", + "field3": "56077", + "icon3": 1, + "field4": "102", + "icon4": 3 + }] +} +``` + ## 系统提示消息（`msg_type=18`） 此类型消息仅可接收，不可直接发送 根对象： -| 字段 | 类型 | 内容 | 备注 | -| ------- | ----- | -------- | ---- | -| content | array | 提示列表 | | +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ---------------------- | +| content | str | 提示列表 | 经过序列化后的JSON数组 | -`content`数组： +`content`文本经JSON解析后的数组： -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------- | ---------------------- | -| 0 | str | 提示1 | 经过序列化后的JSON对象 | -| n | str | 提示(n+1) | | -| …… | str | …… | …… | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---- | +| 0 | obj | 提示1 | | +| n | obj | 提示(n+1) | | +| …… | obj | …… | …… | -`content`数组中的JSON文本解析后的对象： +`content`文本经JSON解析后的数组中的对象： | 字段 | 类型 | 内容 | 备注 | | --------- | ---- | ------------------------ | ----------- | diff --git a/docs/user/info.md b/docs/user/info.md index 45beb88..50db526 100644 --- a/docs/user/info.md +++ b/docs/user/info.md @@ -939,7 +939,7 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \ 认证方式：Cookie(SESSDATA) -本接口较其他接口相比，只会返回非常有限的信息，但可以同时获取较多的用户信息（据测试可以同时获取 40000 多个用户的信息） +本接口较其他接口相比，只会返回非常有限的信息，但可以同时获取较多的用户信息（据测试可以一次性获取 40000 多个用户的信息） **url参数：** diff --git a/docs/user/relation.md b/docs/user/relation.md index 78f81e1..fbe4eb2 100644 --- a/docs/user/relation.md +++ b/docs/user/relation.md @@ -1303,7 +1303,7 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
22001：不能对自己进行此操作
22003：用户位于黑名单
22013：账号已注销，无法完成操作
22014：已经关注用户，无法重复关注
40061：用户不存在 | +| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
22001：不能对自己进行此操作
22002：因对方隐私设置，你还不能关注
22003：关注失败，请将该用户移除黑名单之后再试
22013：账号已注销，无法完成操作
22014：已经关注用户，无法重复关注
22120：重复加入黑名单
40061：用户不存在 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | |