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 | |