diff --git a/docs/message/private_msg.md b/docs/message/private_msg.md index 1a5beff..f88f238 100644 --- a/docs/message/private_msg.md +++ b/docs/message/private_msg.md @@ -352,7 +352,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条消息~ | | 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 9345c2f..87a8190 100644 --- a/docs/message/private_msg_content.md +++ b/docs/message/private_msg_content.md @@ -80,16 +80,152 @@ 此类型消息仅可接收,不可直接发送 +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----------------- | ----- | ------------- | ------------------------- | +| title | str | 通知标题 | | +| text | str | 通知内容 | | +| jump_text | str | 按钮1提示文字 | | +| jump_uri | str | 按钮1跳转链接 | | +| modules | array | 详细信息 | | +| jump_text_2 | str | 按钮2提示文字 | | +| jump_uri_2 | str | 按钮2跳转链接 | | +| jump_text_3 | str | 按钮3提示文字 | | +| jump_uri_3 | str | 按钮3跳转链接 | | +| notifier | obj | 发送者信息 | | +| jump_uri_config | obj | 按钮1配置 | | +| jump_uri_2_config | obj | 按钮2配置 | | +| jump_uri_3_config | obj | 按钮3配置 | | +| biz_content | obj | 扩展信息 | | + +**示例:** + +```json +{ + "title": "直播开始提醒", + "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": "哔哩哔哩拜年纪" + } + ], + "jump_text_2": "", + "jump_uri_2": "", + "jump_text_3": "", + "jump_uri_3": "", + "notifier": null, + "jump_uri_config": { + "all_uri": "https://live.bilibili.com/22747055?broadcast_type=0&is_room_feed=1&live_from=27040", + "text": "进入直播间" + }, + "jump_uri_2_config": { + "text": "" + }, + "jump_uri_3_config": { + "text": "" + }, + "biz_content": { + "cover": "", + "backup_cover": "http://i0.hdslb.com/bfs/live/new_room_cover/bdae2665883ec8aa4e79aca16f3c5ee2df1da64f.jpg", + "refresh_type": 1, + "biz_type": 2, + "biz_id1": "1868902080", + "biz_id2": "473923647994271663", + "biz_status": 0 + } +} +``` ## 视频推送消息(`msg_type=11`) 此类型消息仅可接收,不可直接发送 +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ---- | ------------ | ------------------------------------------------------ | +| title | str | 视频标题 | 接收私信时实时更新此项,若视频失效则为空文本 | +| times | num | 视频时长 | 以秒为单位,接收私信时实时更新此项,若视频失效则为 `0` | +| cover | str | 视频封面 | 接收私信时实时更新此项,若视频失效则为空文本 | +| rid | num | 视频AV号 | | +| type_ | num | (?) | **作用尚不明确** | +| desc | str | 视频简介 | 接收私信时实时更新此项,若视频失效则为空文本 | +| bvid | str | 视频BV号 | | +| view | num | 视频播放量 | 接收私信时实时更新此项,若视频失效则为 `0` | +| danmaku | num | 视频弹幕数 | 接收私信时实时更新此项,若视频失效则为 `0` | +| pub_date | num | 视频发布时间 | 秒级时间戳,若视频失效则为 `0` | +| attach_msg | 有效时:obj
无效时:null | UP主赠言 | | + +**示例:** + +```json +{ + "title": "【2023嵌入式大赛】浅浅测试一下龙芯开发板", + "times": 308, + "cover": "http://i2.hdslb.com/bfs/archive/880c937de9af758451aa94ee29771e0264c1903a.jpg", + "rid": 740817783, + "type_": 8, + "desc": "最近把龙芯开发板部分(任务一)程序完成了,时间非常紧迫,就不知道为啥突然给省赛加个(本来国赛的题\n从硬件焊接开始,到软件整完不过5天啊喂,肝疼,过几天比赛完发硬件制作过程\n硬件使用龙芯一号(LS1B010)SOC,软件使用 C 语言+FreeRTOS+VSCode 开发", + "bvid": "BV1Dk4y1E7MZ", + "view": 13492, + "danmaku": 5, + "pub_date": 1683381582, + "attach_msg": null +} +``` ## 专栏推送消息(`msg_type=12`) 此类型消息仅可接收,不可直接发送 +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ------------ | ------------------------------------------------------ | +| rid | num | 专栏CV号 | | +| title | str | 专栏标题 | 接收私信时实时更新此项,若专栏失效则为 `内容已失效` | +| summary | str | 专栏内容概要 | 接收私信时实时更新此项,若专栏失效则为空文本 | +| author | str | 专栏UP主昵称 | 接收私信时实时更新此项,若专栏失效则为空文本 | +| view | num | 专栏观看数 | 接收私信时实时更新此项,若专栏失效则为 `0` | +| like | num | 专栏点赞数 | 接收私信时实时更新此项,若专栏失效则为 `0` | +| reply | num | 专栏评论数 | 接收私信时实时更新此项,若专栏失效则为 `0` | +| template_id | num | (?) | **作用尚不明确** | +| image_urls | 有效时:array
无效时:null | 专栏封面列表 | 接收私信时实时更新此项,若专栏失效则为 `null` | +| attach_msg | 有效时:obj
无效时:null | UP主赠言 | | +| pub_date | num | 专栏发布时间 | 秒级时间戳,若专栏失效则为 `0` | + +**示例:** + +```json +{ + "rid": 18275013, + "title": "【单片机】遛弯捕捉到野生U盾,点亮它!", + "summary": "前一阵在学校那会,偶然的机会晚上饭后出去遛弯,在路边看到个被抛弃的 U盾,这么一想应该是附近拆迁搬东西时丢出去的,随即捕捉它。作为一个啥都折腾的捡垃圾技术宅肯定要去研究一波(笑是个建行的 U盾,按键部分还有点老灰,屏幕的尺寸盲猜 128x64,不可能再大了背面除了序列号没有别的东西,顶部有个盖子,像极了上古时期的 U盘插上充电宝可以正常点亮,至少屏没坏拆解&分析电路直接开拆,用刀片沿着四周缝隙插入并挑开卡扣内部结构挺简单,只有两颗较大的芯片,屏幕的 FPC 排线直接焊接在 PCB 上中间的这颗是", + "author": "社会易姐QwQ", + "view": 872, + "like": 38, + "reply": 7, + "template_id": 4, + "image_urls": [ + "https://i0.hdslb.com/bfs/article/c7c60e018c43c5c3a6e1520239021ea2753b2880.jpg" + ], + "attach_msg": null, + "pub_date": 1661358081 +} +``` + ## 图片卡片消息(`msg_type=13`) @@ -101,3 +237,33 @@ ## 系统提示消息(`msg_type=18`) 此类型消息仅可接收,不可直接发送 + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | -------- | ---- | +| content | array | 提示列表 | | + +`content`数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---------------------- | +| 0 | str | 提示1 | 经过序列化后的JSON对象 | +| n | str | 提示(n+1) | | +| …… | str | …… | …… | + +`content`数组中的JSON文本解析后的对象: + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---- | ------------------------ | ----------- | +| text | str | 提示文字 | | +| color_day | str | 浅色模式下的提示文字颜色 | HEX颜色代码 | +| color_nig | str | 深色模式下的提示文字颜色 | HEX颜色代码 | + +**示例:** + +```json +{ + "content": "[{\"text\":\"对方主动回复或关注你前,最多发送1条消息\",\"color_day\":\"#9499A0\",\"color_nig\":\"#9499A0\"}]" +} +``` diff --git a/docs/user/relation.md b/docs/user/relation.md index 6cc8b06..78f81e1 100644 --- a/docs/user/relation.md +++ b/docs/user/relation.md @@ -501,9 +501,7 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \ -## 查询用户关注明细3 - - +### 查询用户关注明细3 > https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list