update
This commit is contained in:
wuziqian211
parent
3f0bc38957
commit
b8da0e5b18
@ -10,21 +10,22 @@
|
||||
|
||||
注：私信主体对象≠[私信内容对象](private_msg_content.md)
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ---------------- | ---- | ------------------ | -------------------------------------------------------------- |
|
||||
| sender_uid | num | 发送者mid | |
|
||||
| receiver_type | num | 接收者类型 | 1：用户<br />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<br />无效时：null | at的成员mid | 在粉丝团时有效；此项为 `null` 或 `[0]` 均表示没有 at 成员 |
|
||||
| msg_key | num | 消息唯一id | 部分库在解析JSON对象中的大数时存在数值的精度丢失问题，因此在处理私信时可能会出现问题，建议使用修复了这一问题的库（如将大数转换成文本） |
|
||||
| msg_status | num | 消息状态 | 0：正常<br />1：被撤回（接口仍能返回被撤回的私信内容）<br />2：被系统撤回（私信将不会显示在前端，B站接口也不会返回被系统撤回的私信）<br />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：用户<br />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<br />无效时：null | at的成员mid | 在粉丝团时有效；此项为 `null` 或 `[0]` 均表示没有 at 成员 |
|
||||
| msg_key | num | 消息唯一id | 部分库在解析JSON对象中的大数时存在数值的精度丢失问题，因此在处理私信时可能会出现问题，建议使用修复了这一问题的库（如将大数转换成文本） |
|
||||
| msg_status | num | 消息状态 | 0：正常<br />1：被撤回（接口仍能返回被撤回的私信内容）<br />2：被系统撤回（私信将不会显示在前端，B站接口也不会返回被系统撤回的私信）<br />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：成功<br />-101：账号未登录<br />-400：请求错误<br />10005：msgkey不存在<br />21007：消息过长，无法发送<br />21026：不能给自己发送消息哦~<br />21035：该类消息暂时无法发送<br />21037：图片格式不合法，不要调戏接口啦<br />21041：消息已超期，不能撤回了哦<br />21042：消息已经撤回了哦<br />21046：你发消息的频率太高了，请在24小时后再发吧~<br />21047：对方主动回复或关注你前，最多发送1条消息~ |
|
||||
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />10005：msgkey不存在<br />21007：消息过长，无法发送<br />21026：不能给自己发送消息哦~<br />21035：该类消息暂时无法发送<br />21037：图片格式不合法，不要调戏接口啦<br />21041：消息已超期，不能撤回了哦<br />21042：消息已经撤回了哦<br />21046：你发消息的频率太高了，请在24小时后再发吧~<br />21047：对方主动回复或关注你前，最多发送1条消息~<br />25003：因对方隐私设置，暂无法给他发送聊天消息<br />25005：你已拉黑了对方，请先将对方移出黑名单后才能聊天 |
|
||||
| message | str | 错误信息 | 成功时为0 |
|
||||
| ttl | num | | 默认为1 |
|
||||
| data | 有效时：obj<br />无效时：null | 信息本体 | |
|
||||
|
||||
@ -72,6 +72,34 @@
|
||||
|
||||
## 分享消息（`msg_type=7`）
|
||||
|
||||
根对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ----------- | ---- | ---------------- | -------------------------------------------------------------- |
|
||||
| author | str | 分享内容作者 | 此项不实时更新，在发送私信时设置（非必要） |
|
||||
| headline | str | 分享内容主标题 | 比 `title` 更突出；此项不实时更新，在发送私信时设置（非必要） |
|
||||
| id | num | 分享内容id | |
|
||||
| source | num | 分享内容类型 | ~~1：小视频~~（已弃用）<br />2：相簿<br />3：纯文字<br />4：直播<br />5：视频<br />6：专栏<br />7：番剧（`id` 为 season_id）<br />8：音乐<br />9：国产动画（`id` 为 AV 号）<br />10：图片<br />11：动态<br />16：番剧（`id` 为 epid）<br />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解析后的数组中的对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| --------- | ---- | ------------------------ | ----------- |
|
||||
|
||||
@ -939,7 +939,7 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \
|
||||
|
||||
认证方式：Cookie(SESSDATA)
|
||||
|
||||
本接口较其他接口相比，只会返回非常有限的信息，但可以同时获取较多的用户信息（据测试可以同时获取 40000 多个用户的信息）
|
||||
本接口较其他接口相比，只会返回非常有限的信息，但可以同时获取较多的用户信息（据测试可以一次性获取 40000 多个用户的信息）
|
||||
|
||||
**url参数：**
|
||||
|
||||
|
||||
@ -1303,7 +1303,7 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ------- | ---- | -------- | ------------------------------------------------------------ |
|
||||
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22001：不能对自己进行此操作<br />22003：用户位于黑名单<br />22013：账号已注销，无法完成操作<br />22014：已经关注用户，无法重复关注<br />40061：用户不存在 |
|
||||
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22001：不能对自己进行此操作<br />22002：因对方隐私设置，你还不能关注<br />22003：关注失败，请将该用户移除黑名单之后再试<br />22013：账号已注销，无法完成操作<br />22014：已经关注用户，无法重复关注<br />22120：重复加入黑名单<br />40061：用户不存在 |
|
||||
| message | str | 错误信息 | 默认为0 |
|
||||
| ttl | num | 1 | |
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user