From 35510b7a088cadead2a2e6455de262e6c4c9e657 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=99=A8=E5=8F=B6=E6=A2=A6=E6=98=A5?= <65224318+wuziqian211@users.noreply.github.com> Date: Sat, 3 May 2025 01:39:08 +0800 Subject: [PATCH] feat: add details & replace spaces --- docs/electric/charge_list.md | 185 +++--- docs/electric/monthly.md | 620 +++++++++++-------- docs/message/private_msg.md | 910 ++++++++++++++-------------- docs/message/private_msg_content.md | 288 ++++----- docs/user/info.md | 2 +- 5 files changed, 1072 insertions(+), 933 deletions(-) diff --git a/docs/electric/charge_list.md b/docs/electric/charge_list.md index 4770ba3..cb68162 100644 --- a/docs/electric/charge_list.md +++ b/docs/electric/charge_list.md @@ -20,7 +20,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ---------------------------- | -| code | num | 返回值 | 0:成功
-400:请求错误
88214:up主未开通充电 | +| code | num | 返回值 | 0:成功
-400:请求错误
88214:up主未开通充电 | | message | str | 错误信息 | | | ttl | num | 0 | | | data | obj | 数据本体 | | @@ -71,8 +71,8 @@ ```shell curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \ --A 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36' \ ---data-urlencode 'up_mid=53456' + -A 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/123.0.0.0 Safari/537.36' \ + --data-urlencode 'up_mid=53456' ```
@@ -80,39 +80,39 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \ ```json { - "code": 0, - "message": "", - "ttl": 0, - "data": { - "count": 8521, - "list": [ - { - "uname": "云梦澡堂", - "avatar": "https://i1.hdslb.com/bfs/face/6589df5fdac0f80593f6a86e4d88dc08e25df3d2.jpg", - "mid": 53456, - "pay_mid": 1555775947, - "rank": 1, - "trend_type": 0, - "vip_info": { "vipDueMsec": 0, "vipStatus": 0, "vipType": 0 }, - "message": "", - "message_hidden": 0 - }, - { - "uname": "在下小天子", - "avatar": "https://i1.hdslb.com/bfs/face/a3bfbe6186889bb50dcd87c1156d07a70227a25b.jpg", - "mid": 53456, - "pay_mid": 508630801, - "rank": 2, - "trend_type": 0, - "vip_info": { "vipDueMsec": 0, "vipStatus": 0, "vipType": 0 }, - "message": "", - "message_hidden": 0 - } - ], - "total_count": 41919, - "total": 41919, - "special_day": 0 - } + "code": 0, + "message": "", + "ttl": 0, + "data": { + "count": 8521, + "list": [ + { + "uname": "云梦澡堂", + "avatar": "https://i1.hdslb.com/bfs/face/6589df5fdac0f80593f6a86e4d88dc08e25df3d2.jpg", + "mid": 53456, + "pay_mid": 1555775947, + "rank": 1, + "trend_type": 0, + "vip_info": { "vipDueMsec": 0, "vipStatus": 0, "vipType": 0 }, + "message": "", + "message_hidden": 0 + }, + { + "uname": "在下小天子", + "avatar": "https://i1.hdslb.com/bfs/face/a3bfbe6186889bb50dcd87c1156d07a70227a25b.jpg", + "mid": 53456, + "pay_mid": 508630801, + "rank": 2, + "trend_type": 0, + "vip_info": { "vipDueMsec": 0, "vipStatus": 0, "vipType": 0 }, + "message": "", + "message_hidden": 0 + } + ], + "total_count": 41919, + "total": 41919, + "special_day": 0 + } } ``` @@ -161,25 +161,36 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \ | 字段 | 类型 | 内容 | 备注 | | ---------- | ---- | ------------------------ | ---------------- | | show | bool | 是否展示视频充电鸣谢名单 | | -| state | num | 充电功能开启状态 | -1:未开通充电功能
1:已开通自定义充电
2:已开通包月、自定义充电
3:已开通高档、自定义充电 | +| state | num | 充电功能开启状态 | -1:未开通充电功能
1:已开通自定义充电
2:已开通包月、自定义充电
3:已开通包月高档、自定义充电 | | title | str | 充电按钮显示文字 | 空字符串或 `充电` 或 `充电中` | | jump_url | str | 跳转url | | | icon | str | 充电图标 | | -| high_level | obj | 高档充电信息 | | +| high_level | obj | 充电专属视频信息 | | +| with_qa_id | num | 充电问答id | | `show_info`中的`high_level`对象: -| 字段 | 类型 | 内容 | 备注 | -| -------------- | ---- | ------------------------ | ---------------- | -| privilege_type | num | | | -| title | str | | | -| sub_title | str | | | -| show_button | bool | | | -| button_text | str | | | -| jump_url | obj | | | -| intro | str | | | -| open | bool | | | -| new | bool | | | +| 字段 | 类型 | 内容 | 备注 | +| -------------- | ---- | ------------------------------ | ---------------- | +| privilege_type | num | 解锁视频所需最低定价档位的代码 | 见[充电档位代码与定价](../electric/monthly.md#充电档位代码privilege_type与定价) | +| title | str | 提示标题 | `该视频为「{充电档位名称}」专属视频` | +| sub_title | str | 提示子标题 | `开通「{充电档位定价}元档包月充电」即可观看` | +| show_button | bool | 是否显示按钮 | | +| button_text | str | 按钮文本 | `去开通` | +| jump_url | obj | 跳转url信息 | 详细信息有待补充 | +| intro | str | 充电介绍语 | | +| open | bool | (?) | | +| new | bool | (?) | | +| question_text | str | (?) | | +| qa_detail_link | str | (?) | | + +`high_level`中的`jump_url`对象: + +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---- | ----------------------- | ---- | +| up_link | str | UP主包月充电购买页面url | | +| paywall_link | str | 视频试看后的提示页面url | | +| previewbar_link | str | 视频预览页面url | | `data`中的`list`数组: @@ -219,16 +230,16 @@ avid方式: ```shell curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \ ---data-urlencode 'mid=53456' \ ---data-urlencode 'aid=967773538' + --data-urlencode 'mid=53456' \ + --data-urlencode 'aid=967773538' ``` bvid方式: ```shell curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \ ---data-urlencode 'mid=53456' \ ---data-urlencode 'bvid=BV1up4y1y77i' + --data-urlencode 'mid=53456' \ + --data-urlencode 'bvid=BV1up4y1y77i' ```
@@ -370,10 +381,10 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \ ```shell curl -G 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRecord' \ ---data-urlencode 'currentPage=1' \ ---data-urlencode 'pageSize=2' \ ---data-urlencode 'customerId=10026' \ --b 'SESSDATA=xxx' + --data-urlencode 'currentPage=1' \ + --data-urlencode 'pageSize=2' \ + --data-urlencode 'customerId=10026' \ + -b 'SESSDATA=xxx' ```
@@ -487,7 +498,7 @@ curl -G 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRecord' \ ```shell curl -G 'https://member.bilibili.com/x/h5/elec/rank/recent' \ --b 'SESSDATA=xxx' + -b 'SESSDATA=xxx' ```
@@ -495,36 +506,36 @@ curl -G 'https://member.bilibili.com/x/h5/elec/rank/recent' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "list": [ - { - "aid": 0, - "bvid": "", - "elec_num": 50, - "title": "", - "uname": "", - "avatar": "", - "ctime": "2020-04-02 03:12:22" - }, - { - "aid": 0, - "bvid": "", - "elec_num": 20, - "title": "", - "uname": "", - "avatar": "", - "ctime": "2020-04-02 03:12:00" - } - ], - "pager": { - "current": 1, - "size": 20, - "total": 38 - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "aid": 0, + "bvid": "", + "elec_num": 50, + "title": "", + "uname": "", + "avatar": "", + "ctime": "2020-04-02 03:12:22" + }, + { + "aid": 0, + "bvid": "", + "elec_num": 20, + "title": "", + "uname": "", + "avatar": "", + "ctime": "2020-04-02 03:12:00" + } + ], + "pager": { + "current": 1, + "size": 20, + "total": 38 } + } } ``` diff --git a/docs/electric/monthly.md b/docs/electric/monthly.md index 24dcdcc..9bed7cc 100644 --- a/docs/electric/monthly.md +++ b/docs/electric/monthly.md @@ -75,7 +75,7 @@ | item | array | 充电详情 | | | start | num | 开始充电时间 | 秒级时间戳 | | high_level_state | num | 是否可对UP主进行高档充电 | | -| elec_reply_state | num | 是否可对UP主进行专属问答 | 0:否
1:是
2:(?) | +| elec_reply_state | num | 是否可对UP主进行专属问答 | 0:否
1:是
2:状态未知 | 数组`list`中的对象中的`item`数组: @@ -85,7 +85,6 @@ | n | obj | 充电档位(n+1) | | | …… | obj | …… | …… | - 数组`item`中的对象: | 字段 | 类型 | 内容 | 备注 | @@ -111,18 +110,17 @@ | signed_price | num | 下次续费金额 | 单位为千分之一元人民币 | | pay_channel | num | 签约平台 | 2:微信支付
4:支付宝 | | period | num | 下次充电天数 | | -| mobile_app | num | 充电渠道 | 可为`android`等 | +| mobile_app | str | 充电渠道 | 可为`android`等 | **示例:** 获取自己正在使用的包月充电的列表 - ```shell curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \ ---data-urlencode 'page=1' \ ---data-urlencode 'type=1' \ --b 'SESSDATA=xxx' + --data-urlencode 'page=1' \ + --data-urlencode 'type=1' \ + -b 'SESSDATA=xxx' ```
@@ -130,108 +128,107 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "list": [ - { - "up_uid": 2233, - "user_name": "2233", - "user_face": "https://i0.hdslb.com/bfs/face/noface.jpg", - "item": [ - { - "privilege_type": 10, - "icon": "https://s1.hdslb.com/bfs/templar/york-static/lightning_icon@2x.png", - "name": "为TA充电", - "expire_time": 1703519999, - "renew": { - "uid": 425503913, - "ruid": 2233, - "goods_id": 174, - "status": 1, - "next_execute_time": 1703174400, - "signed_time": 1671618921, - "signed_price": 36000, - "pay_channel": 2, - "period": 366, - "mobile_app": "android" - }, - "start_time": 1671618921, - "renew_list": [ - { - "uid": 425503913, - "ruid": 2233, - "goods_id": 174, - "status": 1, - "next_execute_time": 1703174400, - "signed_time": 1671618921, - "signed_price": 36000, - "pay_channel": 2, - "period": 366, - "mobile_app": "android" - } - ] - } - ], - "start": 1669183804, - "high_level_state": 1, - "elec_reply_state": 1 + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": [ + { + "up_uid": 2233, + "user_name": "2233", + "user_face": "https://i0.hdslb.com/bfs/face/noface.jpg", + "item": [ + { + "privilege_type": 10, + "icon": "https://s1.hdslb.com/bfs/templar/york-static/lightning_icon@2x.png", + "name": "为TA充电", + "expire_time": 1703519999, + "renew": { + "uid": 425503913, + "ruid": 2233, + "goods_id": 174, + "status": 1, + "next_execute_time": 1703174400, + "signed_time": 1671618921, + "signed_price": 36000, + "pay_channel": 2, + "period": 366, + "mobile_app": "android" }, - { - "up_uid": 293793435, - "user_name": "社会易姐QwQ", - "user_face": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", - "item": [ - { - "privilege_type": 10, - "icon": "https://s1.hdslb.com/bfs/templar/york-static/lightning_icon@2x.png", - "name": "为TA充电", - "expire_time": 1681401599, - "renew": { - "uid": 425503913, - "ruid": 293793435, - "goods_id": 173, - "status": 1, - "next_execute_time": 1680364800, - "signed_time": 1677760921, - "signed_price": 5000, - "pay_channel": 4, - "period": 31, - "mobile_app": "android" - }, - "start_time": 1677760921, - "renew_list": [ - { - "uid": 425503913, - "ruid": 293793435, - "goods_id": 173, - "status": 1, - "next_execute_time": 1680364800, - "signed_time": 1677760921, - "signed_price": 5000, - "pay_channel": 4, - "period": 31, - "mobile_app": "android" - } - ] - } - ], - "start": 1676033795, - "high_level_state": 1, - "elec_reply_state": 1 - } + "start_time": 1671618921, + "renew_list": [ + { + "uid": 425503913, + "ruid": 2233, + "goods_id": 174, + "status": 1, + "next_execute_time": 1703174400, + "signed_time": 1671618921, + "signed_price": 36000, + "pay_channel": 2, + "period": 366, + "mobile_app": "android" + } + ] + } ], - "page": 1, - "page_size": 10, - "total_page": 3, - "total_num": 22, - "is_more": 1 - } + "start": 1669183804, + "high_level_state": 1, + "elec_reply_state": 1 + }, + { + "up_uid": 293793435, + "user_name": "社会易姐QwQ", + "user_face": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", + "item": [ + { + "privilege_type": 10, + "icon": "https://s1.hdslb.com/bfs/templar/york-static/lightning_icon@2x.png", + "name": "为TA充电", + "expire_time": 1681401599, + "renew": { + "uid": 425503913, + "ruid": 293793435, + "goods_id": 173, + "status": 1, + "next_execute_time": 1680364800, + "signed_time": 1677760921, + "signed_price": 5000, + "pay_channel": 4, + "period": 31, + "mobile_app": "android" + }, + "start_time": 1677760921, + "renew_list": [ + { + "uid": 425503913, + "ruid": 293793435, + "goods_id": 173, + "status": 1, + "next_execute_time": 1680364800, + "signed_time": 1677760921, + "signed_price": 5000, + "pay_channel": 4, + "period": 31, + "mobile_app": "android" + } + ] + } + ], + "start": 1676033795, + "high_level_state": 1, + "elec_reply_state": 1 + } + ], + "page": 1, + "page_size": 10, + "total_page": 3, + "total_num": 22, + "is_more": 1 + } } ``` -
表示自己从2022-11-23 14:10:04开始给“2233”包月充电,并且在2022-12-21 18:35:21在微信开通了连续包年充电,在2023-12-22 00:00:00的时候会自动续费36元,并继续充电366天; @@ -254,20 +251,26 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \ 根对象: -| 字段 | 类型 | 内容 | 备注 | -| ------- | ---- | -------- | --------------------------------------------------------------- | -| code | num | 返回值 | 0:成功
-400:请求错误
203101:UP主未开通包月充电功能 | -| message | str | 错误信息 | 默认为0 | -| ttl | num | 1 | | -| data | obj | 信息本体 | | +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | --------------------------- | +| code | num | 返回值 | 0:成功
-400:请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | `data`对象: -| 字段 | 类型 | 内容 | 备注 | -| ----------- | ---- | ---------- | ---- | -| upower_rank | obj | 充电详情 | | -| item | obj | 充电欢迎语 | | -| user_card | obj | UP主信息 | | +| 字段 | 类型 | 内容 | 备注 | +| ------------------ | ---- | -------------------------- | ------------------------------ | +| upower_rank | obj | 充电详情 | | +| item | obj | 充电欢迎语信息 | | +| user_card | obj | UP主信息 | | +| upower_level | num | UP主开通的充电等级 | 1:非高档充电
2:高档充电 | +| elec_reply_state | num | 是否可对UP主进行专属问答 | | +| voucher_state | obj | 包月充电券信息 | **详细信息有待补充** | +| upower_right_count | obj | 不同充电档位下的充电权益数 | | +| only_contain_medal | bool | 享有的权益仅为粉丝勋章 | | +| privilege_type | num | 当前给该UP主包月充电的档位 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价),若从未给该UP主包月充电过则为0 | `data`中的`upower_rank`对象: @@ -279,13 +282,13 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \ `upower_rank`中的`list`数组: -| 项 | 类型 | 内容 | 备注 | -| ---- | ---- | --------- | ---------------- | -| 0 | obj | 用户1 | | -| n | obj | 用户(n+1) | 按照充电时间排序 | -| …… | obj | …… | …… | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | -------------------------- | +| 0 | obj | 用户1 | | +| n | obj | 用户(n+1) | 按照最初充电时间排序(?) | +| …… | obj | …… | …… | -数组`list`中的对象: +`list`数组中的对象: | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | --------------- | ---- | @@ -308,15 +311,20 @@ curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \ | avatar | str | UP主头像url | | | nickname | str | UP主昵称 | | +`data`中的`upower_right_count`对象: + +| 字段 | 类型 | 内容 | 备注 | +| -------------- | ---- | -------------------- | ---- | +| {充电档位代码} | num | 该档位下的充电权益数 | | + **示例:** -获取`mid=293793435`的包月充电详情 - +获取`mid=1265680561`的包月充电详情 ```shell curl 'https://api.bilibili.com/x/upower/item/detail' \ ---data-urlencode 'up_mid=293793435' \ --b 'SESSDATA=xxx' + --data-urlencode 'up_mid=1265680561' \ + -b 'SESSDATA=xxx' ```
@@ -324,31 +332,63 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "upower_rank": { - "total": 1, - "total_desc": "1+", - "list": [ - { - "rank": 1, - "mid": 425503913, - "nickname": "晨叶梦春", - "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg" - } - ] + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "upower_rank": { + "total": 5082, + "total_desc": "5000+", + "list": [ + { + "rank": 1, + "mid": 1476475459, + "nickname": "一只屑椒", + "avatar": "https://i1.hdslb.com/bfs/face/dc721da215f4651e0472d566b146ee8fdf198dbe.jpg" }, - "item": { - "intro_video_aid": "", - "welcomes": "哈喽b站的小伙伴们,我的充电计划升级啦! 感兴趣就多多支持我吧~(゜-゜)つロ" + { + "rank": 2, + "mid": 275365317, + "nickname": "-陪我去看海吧i", + "avatar": "https://i0.hdslb.com/bfs/face/dd7547b13020e7f47549ad7908fd3fc58efadefc.jpg" }, - "user_card": { - "avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", - "nickname": "社会易姐QwQ" + { + "rank": 3, + "mid": 401909111, + "nickname": "Vege5able", + "avatar": "https://i2.hdslb.com/bfs/face/46b1fdc94c7851ec0c47817adeec13e3225da559.jpg" } - } + ] + }, + "item": { + "intro_video_aid": "", + "welcomes": "哈喽b站的小伙伴们,我的充电计划升级啦! 感兴趣就多多支持我吧~(゜-゜)つロ" + }, + "user_card": { + "avatar": "https://i1.hdslb.com/bfs/face/5ddddba98f0265265662a8f7d5383e528a98412b.jpg", + "nickname": "永雏塔菲" + }, + "upower_level": 1, + "elec_reply_state": 1, + "voucher_state": { + "voucher_order_id": "95843e812210c455d1ea6e4714bf105a00", + "user_voucher_state": 2, + "vip_action": 0, + "voucher_name": "包月充电券(6元档)", + "validate_price": 0, + "validate_level": 0, + "activity": "", + "common_time": 0, + "high_level_time": 0, + "specify_up": 0, + "specify_level": 0 + }, + "upower_right_count": { + "10": 3 + }, + "only_contain_medal": false, + "privilege_type": 0 + } } ``` @@ -381,15 +421,19 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \ `data`对象: -| 字段 | 类型 | 内容 | 备注 | -| ---------------- | ---- | ------------------------ | ------------------------------------------- | -| days | num | 已保持多少天包月充电状态 | | -| up_card | obj | UP主信息 | | -| user_card | obj | 自己的信息 | | -| remain_days | num | 剩余天数 | 未处于包月充电状态为-1 | -| remain_less_1day | num | 剩余的天数小于1天 | 0:否
1:是
未处于包月充电状态为0 | -| upower_rank | obj | 充电详情 | | -| upower_icon | str | 充电图标url | 仅在处于包月充电状态时有内容 | +| 字段 | 类型 | 内容 | 备注 | +| ------------------ | ---- | ------------------------------ | ------------------------------------------- | +| days | num | 已保持多少天包月充电状态 | | +| up_card | obj | UP主信息 | | +| user_card | obj | 自己的信息 | | +| remain_days | num | 剩余天数 | 未处于包月充电状态为-1 | +| remain_less_1day | num | 剩余的天数是否小于1天 | 0:否
1:是
未处于包月充电状态为0 | +| upower_rank | obj | 充电详情 | | +| upower_icon | str | 充电图标url | 仅在处于包月充电状态时有内容 | +| upower_right_count | obj | 当前自己享有该UP主的充电权益数 | | +| only_contain_medal | bool | 享有的权益仅为粉丝勋章 | | +| privilege_type | num | 当前给该UP主包月充电的档位代码 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价),若未处于包月充电状态为0 | +| challenge_info | obj | 充电挑战信息 | **详细信息有待补充** | `data`中的`up_card`对象: @@ -436,11 +480,10 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \ 获取与`mid=293793435`的包月充电关系 - ```shell curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ ---data-urlencode 'up_mid=293793435' \ --b 'SESSDATA=xxx' + --data-urlencode 'up_mid=293793435' \ + -b 'SESSDATA=xxx' ```
@@ -448,37 +491,53 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "days": 17, - "up_card": { - "mid": 293793435, - "nickname": "社会易姐QwQ", - "official_title": "", - "avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg" - }, - "user_card": { - "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg", - "nickname": "晨叶梦春" - }, - "remain_days": 15, - "remain_less_1day": 0, - "upower_rank": { - "total": 1, - "total_desc": "1+", - "list": [ - { - "rank": 1, - "mid": 425503913, - "nickname": "晨叶梦春", - "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg" - } - ] - }, - "upower_icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png" + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "days": 17, + "up_card": { + "mid": 293793435, + "nickname": "社会易姐QwQ", + "official_title": "", + "avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg" + }, + "user_card": { + "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg", + "nickname": "晨叶梦春" + }, + "remain_days": 15, + "remain_less_1day": 0, + "upower_rank": { + "total": 1, + "total_desc": "1+", + "list": [ + { + "rank": 1, + "mid": 425503913, + "nickname": "晨叶梦春", + "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg" + } + ] + }, + "upower_icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png", + "upower_right_count": 2, + "only_contain_medal": false, + "privilege_type": 10, + "challenge_info": { + "challenge_id": "", + "description": "", + "challenge_type": 0, + "remaining_days": 0, + "end_time": "", + "progress": 0, + "targets": [], + "state": 0, + "end_time_unix": 0, + "pub_dyn": 0, + "dyn_content": "" } + } } ``` @@ -496,11 +555,12 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ **url参数:** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | ----------- | ------ | -------- | -| up_mid | num | 目标用户mid | 必要 | | -| ps | num | 每页项数 | 非必要 | 默认为20 | -| pn | num | 页码 | 非必要 | 默认为1 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| -------------- | ---- | ------------ | ------ | --------- | +| up_mid | num | 目标用户mid | 必要 | | +| ps | num | 每页项数 | 必要 | 最大为101 | +| pn | num | 页码 | 必要 | | +| privilege_type | num | 充电档位代码 | 非必要 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价),默认为可以显示排名的档位中**最高定价**的档位 | **json回复:** @@ -515,22 +575,27 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ `data`对象: -| 字段 | 类型 | 内容 | 备注 | -| ------------ | ----- | ------------ | ---- | -| up_info | obj | UP主信息 | | -| rank_info | array | 充电用户排名 | | -| user_info | obj | 自己的信息 | | -| member_total | num | 充电用户总数 | | +| 字段 | 类型 | 内容 | 备注 | +| -------------- | ----- | ------------------------------ | -------- | +| up_info | obj | UP主信息 | | +| rank_info | array | 当前档位的充电用户排名 | | +| user_info | obj | 自己在该档位下与UP主的充电关系 | | +| member_total | num | 当前档位的充电用户总数 | | +| privilege_type | num | 当前充电档位代码 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价) | +| is_charge | bool | 自己是否给该UP主包月充电过 | 无论档位 | +| tabs | array | 可显示排名的充电档位代码列表 | | +| level_info | array | 可显示排名的充电档位信息 | | `data`中的`up_info`对象: -| 字段 | 类型 | 内容 | 备注 | -| -------- | ---- | ------------ | ---------------------------------------- | -| mid | num | UP主mid | | -| nickname | str | UP主昵称 | | -| avatar | str | UP主头像url | | -| type | num | UP主认证类型 | -1:无
0:UP主认证
1:机构认证 | -| title | str | UP主认证文字 | | +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ---- | -------------------- | ---------------------------------------- | +| mid | num | UP主mid | | +| nickname | str | UP主昵称 | | +| avatar | str | UP主头像url | | +| type | num | UP主认证类型 | -1:无
0:UP主认证
1:机构认证 | +| title | str | UP主认证文字 | | +| upower_state | num | UP主充电功能开启状态 | 0:未开通充电功能
1:已开通自定义充电
2:已开通包月、自定义充电
3:已开通包月高档、自定义充电 | `data`中的`rank_info`数组: @@ -559,19 +624,46 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ | mid | num | 用户mid | | | nickname | str | 用户昵称 | | | avatar | str | 用户头像url | | -| rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 | +| rank | num | 包月充电排名 | 不在该充电档位用户列表里为-1 | | day | num | 包月充电天数 | | -| expire_at | num | 包月充电过期时间 | 秒级时间戳,若从未给UP主包月充电为0 | -| remain_days | num | 未过期时:剩余天数
已过期且之前给UP主包月充电过:自过期以来的天数 | | +| expire_at | num | 包月充电过期时间 | 秒级时间戳,若从未给UP主在该档位下包月充电过为0 | +| remain_days | num | 剩余天数 | 若该档位充电状态已失效为0 | + +`data`中的`tabs`数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | ------------- | ---------------- | +| 0 | num | 档位代码1 | | +| n | num | 档位代码(n+1) | | +| …… | num | …… | …… | + +`data`中的`level_info`数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---------------- | +| 0 | obj | 档位1 | | +| n | obj | 档位(n+1) | | +| …… | obj | …… | …… | + +`level_info`数组中的对象: + +| 字段 | 类型 | 内容 | 备注 | +| -------------- | ---- | -------------------- | ---------------------- | +| privilege_type | num | 当前充电档位代码 | 见[充电档位代码与定价](#充电档位代码privilege_type与定价) | +| name | str | 档位名称 | | +| price | num | 档位价格 | 单位为百分之一元人民币 | +| member_total | num | 当前档位的用户总数 | | **示例:** -获取给`mid=293793435`包月充电的用户排名 +获取给`mid=686127`包月充电的用户排名 ```shell curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \ ---data-urlencode 'up_mid=293793435' \ --b 'SESSDATA=xxx' + --data-urlencode 'up_mid=686127' \ + --data-urlencode 'ps=3' \ + --data-urlencode 'pn=1' \ + -b 'SESSDATA=xxx' ```
@@ -579,39 +671,75 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "up_info": { - "mid": 293793435, - "nickname": "社会易姐QwQ", - "avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", - "type": -1, - "title": "" - }, - "rank_info": [ - { - "mid": 425503913, - "nickname": "晨叶梦春", - "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg", - "rank": 1, - "day": 31, - "expire_at": 0, - "remain_days": 0 - } - ], - "user_info": { - "mid": 425503913, - "nickname": "晨叶梦春", - "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg", - "rank": 1, - "day": 31, - "expire_at": 1678723199, - "remain_days": 15 - }, - "member_total": 1 - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "up_info": { + "mid": 686127, + "nickname": "籽岷", + "avatar": "https://i0.hdslb.com/bfs/face/7efb679569b2faeff38fa08f6f992fa1ada5e948.webp", + "type": 0, + "title": "2024百大UP主、知名游戏UP主", + "upower_state": 3 + }, + "rank_info": [ + { + "mid": 187012867, + "nickname": "是我灬不配", + "avatar": "https://i1.hdslb.com/bfs/face/ad4d2ce0705fd766a0ade315f5a6a5984ce479f4.jpg", + "rank": 1, + "day": 682, + "expire_at": 0, + "remain_days": 0 + }, + { + "mid": 20135495, + "nickname": "和平时一样鸽", + "avatar": "https://i2.hdslb.com/bfs/face/0eef725964105f39b1f000a59f232d9094017544.jpg", + "rank": 2, + "day": 620, + "expire_at": 0, + "remain_days": 0 + }, + { + "mid": 490065730, + "nickname": "乔治Y-GYhaha", + "avatar": "https://i1.hdslb.com/bfs/face/e1753e1e43d7a7df5333c5a2f4d3ec1d0334ebe6.jpg", + "rank": 3, + "day": 527, + "expire_at": 0, + "remain_days": 0 + } + ], + "user_info": { + "mid": 425503913, + "nickname": "晨叶梦春", + "avatar": "https://i2.hdslb.com/bfs/face/540ed71e2fb2ddd8967c21b392026c34fc15673e.jpg", + "rank": -1, + "day": 0, + "expire_at": 0, + "remain_days": 0 + }, + "member_total": 46881, + "privilege_type": 50, + "is_charge": false, + "tabs": [50, 10], + "level_info": [ + { + "privilege_type": 50, + "name": "审稿", + "price": 12800, + "member_total": 1082 + }, + { + "privilege_type": 10, + "name": "石粒", + "price": 600, + "member_total": 46158 + } + ] + } } ``` diff --git a/docs/message/private_msg.md b/docs/message/private_msg.md index edc113f..a75b1fa 100644 --- a/docs/message/private_msg.md +++ b/docs/message/private_msg.md @@ -144,12 +144,12 @@ ```shell curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \ - --data-urlencode 'unread_type=0' \ - --data-urlencode 'show_unfollow_list=1' \ - --data-urlencode 'show_dustbin=1' \ - --data-urlencode 'build=0' \ - --data-urlencode 'mobi_app=web' \ - -b 'SESSDATA=xxx' + --data-urlencode 'unread_type=0' \ + --data-urlencode 'show_unfollow_list=1' \ + --data-urlencode 'show_dustbin=1' \ + --data-urlencode 'build=0' \ + --data-urlencode 'mobi_app=web' \ + -b 'SESSDATA=xxx' ```
@@ -157,20 +157,20 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \ ```json { - "code": 0, - "msg": "0", - "message": "0", - "ttl": 1, - "data": { - "unfollow_unread": 1, - "follow_unread": 6, - "unfollow_push_msg": 0, - "dustbin_push_msg": 0, - "dustbin_unread": 0, - "biz_msg_unfollow_unread": 0, - "biz_msg_follow_unread": 0, - "custom_unread": 0 - } + "code": 0, + "msg": "0", + "message": "0", + "ttl": 1, + "data": { + "unfollow_unread": 1, + "follow_unread": 6, + "unfollow_push_msg": 0, + "dustbin_push_msg": 0, + "dustbin_unread": 0, + "biz_msg_unfollow_unread": 0, + "biz_msg_follow_unread": 0, + "custom_unread": 0 + } } ``` @@ -241,14 +241,14 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/single_unread' \ ```shell curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/get_sessions' \ - --data-urlencode 'session_type=1' \ - --data-urlencode 'group_fold=0' \ - --data-urlencode 'unfollow_fold=0' \ - --data-urlencode 'sort_rule=2' \ - --data-urlencode 'size=3' \ - --data-urlencode 'build=0' \ - --data-urlencode 'mobi_app=web' \ - -b 'SESSDATA=xxx' + --data-urlencode 'session_type=1' \ + --data-urlencode 'group_fold=0' \ + --data-urlencode 'unfollow_fold=0' \ + --data-urlencode 'sort_rule=2' \ + --data-urlencode 'size=3' \ + --data-urlencode 'build=0' \ + --data-urlencode 'mobi_app=web' \ + -b 'SESSDATA=xxx' ```
@@ -256,152 +256,152 @@ curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/get_sessions' \ ```json { - "code": 0, - "msg": "0", - "message": "0", - "ttl": 1, - "data": { - "session_list": [ - { - "talker_id": 844424930131966, - "session_type": 1, - "at_seqno": 0, - "top_ts": 0, - "group_name": "", - "group_cover": "", - "is_follow": 1, - "is_dnd": 0, - "ack_seqno": 1238729956474887, - "ack_ts": 1709536924979884, - "session_ts": 1712305278098351, - "unread_count": 4, - "last_msg": { - "sender_uid": 844424930131966, - "receiver_type": 1, - "receiver_id": 425503913, - "msg_type": 10, - "content": "{\"title\":\"流量奖励到账通知\",\"text\":\"恭喜您已获得2000流量曝光奖励,快来投稿使用吧。\",\"jump_text\":\"\",\"jump_uri\":\"\",\"modules\":null,\"jump_text_2\":\"\",\"jump_uri_2\":\"\",\"jump_text_3\":\"\",\"jump_uri_3\":\"\",\"notifier\":null,\"jump_uri_config\":{\"all_uri\":\"https://member.bilibili.com/york/flow-reward?navhide=1\\u0026from=msgrecall\",\"text\":\"\"},\"jump_uri_2_config\":{\"text\":\"\"},\"jump_uri_3_config\":{\"text\":\"\"},\"biz_content\":null}", - "msg_seqno": 1285290404823041, - "timestamp": 1712305278, - "at_uids": null, - "msg_key": 7354295169819585966, - "msg_status": 0, - "notify_code": "2091_253", - "new_face_version": 1, - "msg_source": 6 - }, - "group_type": 0, - "can_fold": 0, - "status": 0, - "max_seqno": 1285290404823041, - "new_push_msg": 1, - "setting": 0, - "is_guardian": 0, - "is_intercept": 0, - "is_trust": 0, - "system_msg_type": 7, - "account_info": { - "name": "UP主小助手", - "pic_url": "https://message.biliimg.com/bfs/im/489a63efadfb202366c2f88853d2217b5ddc7a13.png" - }, - "live_status": 0, - "biz_msg_unread_count": 0, - "user_label": null - }, - { - "talker_id": 293793435, - "session_type": 1, - "at_seqno": 0, - "top_ts": 0, - "group_name": "", - "group_cover": "", - "is_follow": 1, - "is_dnd": 0, - "ack_seqno": 1236306587877408, - "ack_ts": 1709536984481314, - "session_ts": 1709385615744065, - "unread_count": 0, - "last_msg": { - "sender_uid": 293793435, - "receiver_type": 1, - "receiver_id": 425503913, - "msg_type": 11, - "content": "{\"title\":\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\",\"times\":14,\"cover\":\"http://i0.hdslb.com/bfs/archive/8821c03ab27a0bcf2bf32af814e758ab17a1e27e.png\",\"rid\":1951316064,\"type_\":8,\"desc\":\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\",\"bvid\":\"BV1zC411p7JN\",\"view\":452,\"danmaku\":0,\"pub_date\":1709385603,\"attach_msg\":null}", - "msg_seqno": 1236306587877408, - "timestamp": 1709385615, - "at_uids": null, - "msg_key": 7341755312943193481, - "msg_status": 0, - "notify_code": "", - "new_face_version": 1, - "msg_source": 6 - }, - "group_type": 0, - "can_fold": 0, - "status": 0, - "max_seqno": 1236306587877408, - "new_push_msg": 0, - "setting": 0, - "is_guardian": 0, - "is_intercept": 0, - "is_trust": 0, - "system_msg_type": 0, - "live_status": 0, - "biz_msg_unread_count": 0, - "user_label": null - }, - { - "talker_id": 221082140, - "session_type": 2, - "at_seqno": 0, - "top_ts": 0, - "group_name": "社会易姐QwQ的应援团", - "group_cover": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", - "is_follow": 0, - "is_dnd": 0, - "ack_seqno": 20, - "ack_ts": 1695011620552332, - "session_ts": 1693626568439784, - "unread_count": 0, - "last_msg": { - "sender_uid": 0, - "receiver_type": 2, - "receiver_id": 221082140, - "msg_type": 306, - "content": "{\"group_id\":221082140,\"content\":\"欢迎罗板栗入群\"}", - "msg_seqno": 20, - "timestamp": 1693626568, - "at_uids": null, - "msg_key": 7274070721607234847, - "msg_status": 0, - "notify_code": "", - "msg_source": 13 - }, - "group_type": 0, - "can_fold": 0, - "status": 0, - "max_seqno": 20, - "new_push_msg": 0, - "setting": 0, - "is_guardian": 0, - "is_intercept": 0, - "is_trust": 0, - "system_msg_type": 0, - "live_status": 0, - "biz_msg_unread_count": 0, - "user_label": null - } - ], - "has_more": 1, - "anti_disturb_cleaning": false, - "is_address_list_empty": 0, - "system_msg": { - "1": 844424930131967, - "7": 844424930131966, - "9": 844424930131965 + "code": 0, + "msg": "0", + "message": "0", + "ttl": 1, + "data": { + "session_list": [ + { + "talker_id": 844424930131966, + "session_type": 1, + "at_seqno": 0, + "top_ts": 0, + "group_name": "", + "group_cover": "", + "is_follow": 1, + "is_dnd": 0, + "ack_seqno": 1238729956474887, + "ack_ts": 1709536924979884, + "session_ts": 1712305278098351, + "unread_count": 4, + "last_msg": { + "sender_uid": 844424930131966, + "receiver_type": 1, + "receiver_id": 425503913, + "msg_type": 10, + "content": "{\"title\":\"流量奖励到账通知\",\"text\":\"恭喜您已获得2000流量曝光奖励,快来投稿使用吧。\",\"jump_text\":\"\",\"jump_uri\":\"\",\"modules\":null,\"jump_text_2\":\"\",\"jump_uri_2\":\"\",\"jump_text_3\":\"\",\"jump_uri_3\":\"\",\"notifier\":null,\"jump_uri_config\":{\"all_uri\":\"https://member.bilibili.com/york/flow-reward?navhide=1\\u0026from=msgrecall\",\"text\":\"\"},\"jump_uri_2_config\":{\"text\":\"\"},\"jump_uri_3_config\":{\"text\":\"\"},\"biz_content\":null}", + "msg_seqno": 1285290404823041, + "timestamp": 1712305278, + "at_uids": null, + "msg_key": 7354295169819585966, + "msg_status": 0, + "notify_code": "2091_253", + "new_face_version": 1, + "msg_source": 6 }, - "show_level": true - } + "group_type": 0, + "can_fold": 0, + "status": 0, + "max_seqno": 1285290404823041, + "new_push_msg": 1, + "setting": 0, + "is_guardian": 0, + "is_intercept": 0, + "is_trust": 0, + "system_msg_type": 7, + "account_info": { + "name": "UP主小助手", + "pic_url": "https://message.biliimg.com/bfs/im/489a63efadfb202366c2f88853d2217b5ddc7a13.png" + }, + "live_status": 0, + "biz_msg_unread_count": 0, + "user_label": null + }, + { + "talker_id": 293793435, + "session_type": 1, + "at_seqno": 0, + "top_ts": 0, + "group_name": "", + "group_cover": "", + "is_follow": 1, + "is_dnd": 0, + "ack_seqno": 1236306587877408, + "ack_ts": 1709536984481314, + "session_ts": 1709385615744065, + "unread_count": 0, + "last_msg": { + "sender_uid": 293793435, + "receiver_type": 1, + "receiver_id": 425503913, + "msg_type": 11, + "content": "{\"title\":\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\",\"times\":14,\"cover\":\"http://i0.hdslb.com/bfs/archive/8821c03ab27a0bcf2bf32af814e758ab17a1e27e.png\",\"rid\":1951316064,\"type_\":8,\"desc\":\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\",\"bvid\":\"BV1zC411p7JN\",\"view\":452,\"danmaku\":0,\"pub_date\":1709385603,\"attach_msg\":null}", + "msg_seqno": 1236306587877408, + "timestamp": 1709385615, + "at_uids": null, + "msg_key": 7341755312943193481, + "msg_status": 0, + "notify_code": "", + "new_face_version": 1, + "msg_source": 6 + }, + "group_type": 0, + "can_fold": 0, + "status": 0, + "max_seqno": 1236306587877408, + "new_push_msg": 0, + "setting": 0, + "is_guardian": 0, + "is_intercept": 0, + "is_trust": 0, + "system_msg_type": 0, + "live_status": 0, + "biz_msg_unread_count": 0, + "user_label": null + }, + { + "talker_id": 221082140, + "session_type": 2, + "at_seqno": 0, + "top_ts": 0, + "group_name": "社会易姐QwQ的应援团", + "group_cover": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", + "is_follow": 0, + "is_dnd": 0, + "ack_seqno": 20, + "ack_ts": 1695011620552332, + "session_ts": 1693626568439784, + "unread_count": 0, + "last_msg": { + "sender_uid": 0, + "receiver_type": 2, + "receiver_id": 221082140, + "msg_type": 306, + "content": "{\"group_id\":221082140,\"content\":\"欢迎罗板栗入群\"}", + "msg_seqno": 20, + "timestamp": 1693626568, + "at_uids": null, + "msg_key": 7274070721607234847, + "msg_status": 0, + "notify_code": "", + "msg_source": 13 + }, + "group_type": 0, + "can_fold": 0, + "status": 0, + "max_seqno": 20, + "new_push_msg": 0, + "setting": 0, + "is_guardian": 0, + "is_intercept": 0, + "is_trust": 0, + "system_msg_type": 0, + "live_status": 0, + "biz_msg_unread_count": 0, + "user_label": null + } + ], + "has_more": 1, + "anti_disturb_cleaning": false, + "is_address_list_empty": 0, + "system_msg": { + "1": 844424930131967, + "7": 844424930131966, + "9": 844424930131965 + }, + "show_level": true + } } ``` @@ -462,11 +462,11 @@ curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/get_sessions' \ ```shell curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/new_sessions' \ - --data-urlencode 'begin_ts=1712420213519391' \ - --data-urlencode 'size=3' \ - --data-urlencode 'build=0' \ - --data-urlencode 'mobi_app=web' \ - -b 'SESSDATA=xxx' + --data-urlencode 'begin_ts=1712420213519391' \ + --data-urlencode 'size=3' \ + --data-urlencode 'build=0' \ + --data-urlencode 'mobi_app=web' \ + -b 'SESSDATA=xxx' ```
@@ -474,147 +474,147 @@ curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/new_sessions' \ ```json { - "code": 0, - "msg": "0", - "message": "0", - "ttl": 1, - "data": { - "session_list": [ - { - "talker_id": 844424930131966, - "session_type": 1, - "at_seqno": 0, - "top_ts": 0, - "group_name": "", - "group_cover": "", - "is_follow": 1, - "is_dnd": 0, - "ack_seqno": 1238729956474887, - "ack_ts": 1709536924979884, - "session_ts": 1712305278098351, - "unread_count": 4, - "last_msg": { - "sender_uid": 844424930131966, - "receiver_type": 1, - "receiver_id": 425503913, - "msg_type": 10, - "content": "{\"title\":\"流量奖励到账通知\",\"text\":\"恭喜您已获得2000流量曝光奖励,快来投稿使用吧。\",\"jump_text\":\"\",\"jump_uri\":\"\",\"modules\":null,\"jump_text_2\":\"\",\"jump_uri_2\":\"\",\"jump_text_3\":\"\",\"jump_uri_3\":\"\",\"notifier\":null,\"jump_uri_config\":{\"all_uri\":\"https://member.bilibili.com/york/flow-reward?navhide=1\\u0026from=msgrecall\",\"text\":\"\"},\"jump_uri_2_config\":{\"text\":\"\"},\"jump_uri_3_config\":{\"text\":\"\"},\"biz_content\":null}", - "msg_seqno": 1285290404823041, - "timestamp": 1712305278, - "at_uids": null, - "msg_key": 7354295169819585966, - "msg_status": 0, - "notify_code": "2091_253", - "new_face_version": 1, - "msg_source": 6 - }, - "group_type": 0, - "can_fold": 0, - "status": 0, - "max_seqno": 1285290404823041, - "new_push_msg": 1, - "setting": 0, - "is_guardian": 0, - "is_intercept": 0, - "is_trust": 0, - "system_msg_type": 7, - "account_info": { - "name": "UP主小助手", - "pic_url": "https://message.biliimg.com/bfs/im/489a63efadfb202366c2f88853d2217b5ddc7a13.png" - }, - "live_status": 0, - "biz_msg_unread_count": 0, - "user_label": null - }, - { - "talker_id": 293793435, - "session_type": 1, - "at_seqno": 0, - "top_ts": 0, - "group_name": "", - "group_cover": "", - "is_follow": 1, - "is_dnd": 0, - "ack_seqno": 1236306587877408, - "ack_ts": 1709536984481314, - "session_ts": 1709385615744065, - "unread_count": 0, - "last_msg": { - "sender_uid": 293793435, - "receiver_type": 1, - "receiver_id": 425503913, - "msg_type": 11, - "content": "{\"title\":\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\",\"times\":14,\"cover\":\"http://i0.hdslb.com/bfs/archive/8821c03ab27a0bcf2bf32af814e758ab17a1e27e.png\",\"rid\":1951316064,\"type_\":8,\"desc\":\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\",\"bvid\":\"BV1zC411p7JN\",\"view\":452,\"danmaku\":0,\"pub_date\":1709385603,\"attach_msg\":null}", - "msg_seqno": 1236306587877408, - "timestamp": 1709385615, - "at_uids": null, - "msg_key": 7341755312943193481, - "msg_status": 0, - "notify_code": "", - "new_face_version": 1, - "msg_source": 6 - }, - "group_type": 0, - "can_fold": 0, - "status": 0, - "max_seqno": 1236306587877408, - "new_push_msg": 0, - "setting": 0, - "is_guardian": 0, - "is_intercept": 0, - "is_trust": 0, - "system_msg_type": 0, - "live_status": 0, - "biz_msg_unread_count": 0, - "user_label": null - }, - { - "talker_id": 221082140, - "session_type": 2, - "at_seqno": 0, - "top_ts": 0, - "group_name": "社会易姐QwQ的应援团", - "group_cover": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", - "is_follow": 0, - "is_dnd": 0, - "ack_seqno": 20, - "ack_ts": 1695011620552332, - "session_ts": 1693626568439784, - "unread_count": 0, - "last_msg": { - "sender_uid": 0, - "receiver_type": 2, - "receiver_id": 221082140, - "msg_type": 306, - "content": "{\"group_id\":221082140,\"content\":\"欢迎罗板栗入群\"}", - "msg_seqno": 20, - "timestamp": 1693626568, - "at_uids": null, - "msg_key": 7274070721607234847, - "msg_status": 0, - "notify_code": "", - "msg_source": 13 - }, - "group_type": 0, - "can_fold": 0, - "status": 0, - "max_seqno": 20, - "new_push_msg": 0, - "setting": 0, - "is_guardian": 0, - "is_intercept": 0, - "is_trust": 0, - "system_msg_type": 0, - "live_status": 0, - "biz_msg_unread_count": 0, - "user_label": null - } - ], - "has_more": 0, - "anti_disturb_cleaning": false, - "is_address_list_empty": 0, - "show_level": false - } + "code": 0, + "msg": "0", + "message": "0", + "ttl": 1, + "data": { + "session_list": [ + { + "talker_id": 844424930131966, + "session_type": 1, + "at_seqno": 0, + "top_ts": 0, + "group_name": "", + "group_cover": "", + "is_follow": 1, + "is_dnd": 0, + "ack_seqno": 1238729956474887, + "ack_ts": 1709536924979884, + "session_ts": 1712305278098351, + "unread_count": 4, + "last_msg": { + "sender_uid": 844424930131966, + "receiver_type": 1, + "receiver_id": 425503913, + "msg_type": 10, + "content": "{\"title\":\"流量奖励到账通知\",\"text\":\"恭喜您已获得2000流量曝光奖励,快来投稿使用吧。\",\"jump_text\":\"\",\"jump_uri\":\"\",\"modules\":null,\"jump_text_2\":\"\",\"jump_uri_2\":\"\",\"jump_text_3\":\"\",\"jump_uri_3\":\"\",\"notifier\":null,\"jump_uri_config\":{\"all_uri\":\"https://member.bilibili.com/york/flow-reward?navhide=1\\u0026from=msgrecall\",\"text\":\"\"},\"jump_uri_2_config\":{\"text\":\"\"},\"jump_uri_3_config\":{\"text\":\"\"},\"biz_content\":null}", + "msg_seqno": 1285290404823041, + "timestamp": 1712305278, + "at_uids": null, + "msg_key": 7354295169819585966, + "msg_status": 0, + "notify_code": "2091_253", + "new_face_version": 1, + "msg_source": 6 + }, + "group_type": 0, + "can_fold": 0, + "status": 0, + "max_seqno": 1285290404823041, + "new_push_msg": 1, + "setting": 0, + "is_guardian": 0, + "is_intercept": 0, + "is_trust": 0, + "system_msg_type": 7, + "account_info": { + "name": "UP主小助手", + "pic_url": "https://message.biliimg.com/bfs/im/489a63efadfb202366c2f88853d2217b5ddc7a13.png" + }, + "live_status": 0, + "biz_msg_unread_count": 0, + "user_label": null + }, + { + "talker_id": 293793435, + "session_type": 1, + "at_seqno": 0, + "top_ts": 0, + "group_name": "", + "group_cover": "", + "is_follow": 1, + "is_dnd": 0, + "ack_seqno": 1236306587877408, + "ack_ts": 1709536984481314, + "session_ts": 1709385615744065, + "unread_count": 0, + "last_msg": { + "sender_uid": 293793435, + "receiver_type": 1, + "receiver_id": 425503913, + "msg_type": 11, + "content": "{\"title\":\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\",\"times\":14,\"cover\":\"http://i0.hdslb.com/bfs/archive/8821c03ab27a0bcf2bf32af814e758ab17a1e27e.png\",\"rid\":1951316064,\"type_\":8,\"desc\":\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\",\"bvid\":\"BV1zC411p7JN\",\"view\":452,\"danmaku\":0,\"pub_date\":1709385603,\"attach_msg\":null}", + "msg_seqno": 1236306587877408, + "timestamp": 1709385615, + "at_uids": null, + "msg_key": 7341755312943193481, + "msg_status": 0, + "notify_code": "", + "new_face_version": 1, + "msg_source": 6 + }, + "group_type": 0, + "can_fold": 0, + "status": 0, + "max_seqno": 1236306587877408, + "new_push_msg": 0, + "setting": 0, + "is_guardian": 0, + "is_intercept": 0, + "is_trust": 0, + "system_msg_type": 0, + "live_status": 0, + "biz_msg_unread_count": 0, + "user_label": null + }, + { + "talker_id": 221082140, + "session_type": 2, + "at_seqno": 0, + "top_ts": 0, + "group_name": "社会易姐QwQ的应援团", + "group_cover": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", + "is_follow": 0, + "is_dnd": 0, + "ack_seqno": 20, + "ack_ts": 1695011620552332, + "session_ts": 1693626568439784, + "unread_count": 0, + "last_msg": { + "sender_uid": 0, + "receiver_type": 2, + "receiver_id": 221082140, + "msg_type": 306, + "content": "{\"group_id\":221082140,\"content\":\"欢迎罗板栗入群\"}", + "msg_seqno": 20, + "timestamp": 1693626568, + "at_uids": null, + "msg_key": 7274070721607234847, + "msg_status": 0, + "notify_code": "", + "msg_source": 13 + }, + "group_type": 0, + "can_fold": 0, + "status": 0, + "max_seqno": 20, + "new_push_msg": 0, + "setting": 0, + "is_guardian": 0, + "is_intercept": 0, + "is_trust": 0, + "system_msg_type": 0, + "live_status": 0, + "biz_msg_unread_count": 0, + "user_label": null + } + ], + "has_more": 0, + "anti_disturb_cleaning": false, + "is_address_list_empty": 0, + "show_level": false + } } ``` @@ -657,11 +657,11 @@ curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/new_sessions' \ ```shell curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/session_detail' \ - --data-urlencode 'talker_id=293793435' \ - --data-urlencode 'session_type=1' \ - --data-urlencode 'build=0' \ - --data-urlencode 'mobi_app=web' \ - -b 'SESSDATA=xxx' + --data-urlencode 'talker_id=293793435' \ + --data-urlencode 'session_type=1' \ + --data-urlencode 'build=0' \ + --data-urlencode 'mobi_app=web' \ + -b 'SESSDATA=xxx' ```
@@ -669,52 +669,52 @@ curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/session_detail' ```json { - "code": 0, - "msg": "0", - "message": "0", - "ttl": 1, - "data": { - "talker_id": 293793435, - "session_type": 1, - "at_seqno": 0, - "top_ts": 0, - "group_name": "", - "group_cover": "", - "is_follow": 1, - "is_dnd": 0, - "ack_seqno": 1236306587877408, - "ack_ts": 1709536984481314, - "session_ts": 1709385615744065, - "unread_count": 0, - "last_msg": { - "sender_uid": 293793435, - "receiver_type": 1, - "receiver_id": 425503913, - "msg_type": 11, - "content": "{\"title\":\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\",\"times\":14,\"cover\":\"http://i0.hdslb.com/bfs/archive/8821c03ab27a0bcf2bf32af814e758ab17a1e27e.png\",\"rid\":1951316064,\"type_\":8,\"desc\":\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\",\"bvid\":\"BV1zC411p7JN\",\"view\":452,\"danmaku\":0,\"pub_date\":1709385603,\"attach_msg\":null}", - "msg_seqno": 1236306587877408, - "timestamp": 1709385615, - "at_uids": null, - "msg_key": 7341755312943193481, - "msg_status": 0, - "notify_code": "", - "new_face_version": 1, - "msg_source": 6 - }, - "group_type": 0, - "can_fold": 0, - "status": 0, - "max_seqno": 1236306587877408, - "new_push_msg": 0, - "setting": 0, - "is_guardian": 0, - "is_intercept": 0, - "is_trust": 0, - "system_msg_type": 0, - "live_status": 0, - "biz_msg_unread_count": 0, - "user_label": null - } + "code": 0, + "msg": "0", + "message": "0", + "ttl": 1, + "data": { + "talker_id": 293793435, + "session_type": 1, + "at_seqno": 0, + "top_ts": 0, + "group_name": "", + "group_cover": "", + "is_follow": 1, + "is_dnd": 0, + "ack_seqno": 1236306587877408, + "ack_ts": 1709536984481314, + "session_ts": 1709385615744065, + "unread_count": 0, + "last_msg": { + "sender_uid": 293793435, + "receiver_type": 1, + "receiver_id": 425503913, + "msg_type": 11, + "content": "{\"title\":\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\",\"times\":14,\"cover\":\"http://i0.hdslb.com/bfs/archive/8821c03ab27a0bcf2bf32af814e758ab17a1e27e.png\",\"rid\":1951316064,\"type_\":8,\"desc\":\"OHHHHHH家人们,我分数终于破w了!紫框了这下确实不好意思说自己是只打红谱的萌新了\",\"bvid\":\"BV1zC411p7JN\",\"view\":452,\"danmaku\":0,\"pub_date\":1709385603,\"attach_msg\":null}", + "msg_seqno": 1236306587877408, + "timestamp": 1709385615, + "at_uids": null, + "msg_key": 7341755312943193481, + "msg_status": 0, + "notify_code": "", + "new_face_version": 1, + "msg_source": 6 + }, + "group_type": 0, + "can_fold": 0, + "status": 0, + "max_seqno": 1236306587877408, + "new_push_msg": 0, + "setting": 0, + "is_guardian": 0, + "is_intercept": 0, + "is_trust": 0, + "system_msg_type": 0, + "live_status": 0, + "biz_msg_unread_count": 0, + "user_label": null + } } ``` @@ -738,7 +738,7 @@ curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/session_detail' | ----------------- | ---- | ---------------- | ------ | ------------------------------------------------------ | | talker_id | num | 聊天对象的id | 必要 | `session_type` 为 `1` 时表示用户 mid,为 `2` 时表示粉丝团 id | | session_type | num | 聊天对象的类型 | 必要 | 1:用户
2:粉丝团 | -| size | num | 返回消息数量 | 非必要 | 默认为 0,最大为 200
本参数不存在时,只返回系统提示 | +| size | num | 返回消息数量 | 非必要 | 默认为 0,最大为 2000
当本参数为 `0` 或不存在时,只返回系统提示 | | begin_seqno | num | 开始的序列号 | 非必要 | 提供本参数时返回以本序列号开始(不包括本序列号)的消息 | | end_seqno | num | 结束的序列号 | 非必要 | 提供本参数时返回以本序列号结束(不包括本序列号)的消息 | | sender_device_id | num | 发送者设备 | 非必要 | 默认为 `1` | @@ -798,13 +798,13 @@ curl -G 'https://api.vc.bilibili.com/session_svr/v1/session_svr/session_detail' ```shell curl -G 'https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs' \ - --data-urlencode 'talker_id=123' \ - --data-urlencode 'session_type=1' \ - --data-urlencode 'size=20' \ - --data-urlencode 'sender_device_id=1' \ - --data-urlencode 'build=0' \ - --data-urlencode 'mobi_app=web' \ - -b 'SESSDATA=xxx' + --data-urlencode 'talker_id=123' \ + --data-urlencode 'session_type=1' \ + --data-urlencode 'size=20' \ + --data-urlencode 'sender_device_id=1' \ + --data-urlencode 'build=0' \ + --data-urlencode 'mobi_app=web' \ + -b 'SESSDATA=xxx' ```
@@ -812,58 +812,58 @@ curl -G 'https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs' \ ```json { - "code": 0, - "msg": "0", - "message": "0", - "ttl": 1, - "data": { - "messages": [ - { - "sender_uid": 2239814, - "receiver_type": 1, - "receiver_id": 123, - "msg_type": 1, - "content": "{\"content\":\"[口罩]\"}", - "msg_seqno": 309675413389322, - "timestamp": 1654154093, - "at_uids": [ - 0 - ], - "msg_key": 7104537732714964358, - "msg_status": 0, - "notify_code": "", - "new_face_version": 1, - "msg_source": 2 - }, - { - "sender_uid": 2239814, - "receiver_type": 1, - "receiver_id": 123, - "msg_type": 5, - "content": "{\"content\":\"1\"}", - "msg_seqno": 308302399586307, - "timestamp": 1654072255, - "at_uids": [ - 0 - ], - "msg_key": 7104186240789226795, - "msg_status": 0, - "notify_code": "", - "msg_source": 7 - - }, + "code": 0, + "msg": "0", + "message": "0", + "ttl": 1, + "data": { + "messages": [ + { + "sender_uid": 2239814, + "receiver_type": 1, + "receiver_id": 123, + "msg_type": 1, + "content": "{\"content\":\"[口罩]\"}", + "msg_seqno": 309675413389322, + "timestamp": 1654154093, + "at_uids": [ + 0 ], - "has_more": 0, - "min_seqno": 308188515844097, - "max_seqno": 309675413389322, - "e_infos": [ - { - "text": "[口罩]", - "url": "http://i0.hdslb.com/bfs/emote/3ad2f66b151496d2a5fb0a8ea75f32265d778dd3.png", - "size": 1 - } - ] - } + "msg_key": 7104537732714964358, + "msg_status": 0, + "notify_code": "", + "new_face_version": 1, + "msg_source": 2 + }, + { + "sender_uid": 2239814, + "receiver_type": 1, + "receiver_id": 123, + "msg_type": 5, + "content": "{\"content\":\"1\"}", + "msg_seqno": 308302399586307, + "timestamp": 1654072255, + "at_uids": [ + 0 + ], + "msg_key": 7104186240789226795, + "msg_status": 0, + "notify_code": "", + "msg_source": 7 + + }, + ], + "has_more": 0, + "min_seqno": 308188515844097, + "max_seqno": 309675413389322, + "e_infos": [ + { + "text": "[口罩]", + "url": "http://i0.hdslb.com/bfs/emote/3ad2f66b151496d2a5fb0a8ea75f32265d778dd3.png", + "size": 1 + } + ] + } } ``` @@ -911,9 +911,9 @@ curl -G 'https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs' \ ```shell curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/is_limit' \ - --data-urlencode 'uid=123' \ - --data-urlencode 'type=1' \ - -b 'SESSDATA=xxx' + --data-urlencode 'uid=123' \ + --data-urlencode 'type=1' \ + -b 'SESSDATA=xxx' ```
@@ -979,10 +979,10 @@ curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/is_limit' \ ```shell curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/get_session_ss' \ - --data-urlencode 'talker_uid=123' \ - --data-urlencode 'build=0' \ - --data-urlencode 'mobi_app=web' \ - -b 'SESSDATA=xxx' + --data-urlencode 'talker_uid=123' \ + --data-urlencode 'build=0' \ + --data-urlencode 'mobi_app=web' \ + -b 'SESSDATA=xxx' ```
@@ -1111,12 +1111,12 @@ curl -G 'https://api.vc.bilibili.com/link_setting/v1/link_setting/get_session_ss ```shell curl -G 'https://api.vc.bilibili.com/x/im/feed/infoweb' \ - --data-urlencode 'aids=170001' \ - --data-urlencode 'ep_ids=780019' \ - --data-urlencode 'article_ids=1' \ - --data-urlencode 'build=0' \ - --data-urlencode 'mobi_app=web' \ - -b 'SESSDATA=xxx' + --data-urlencode 'aids=170001' \ + --data-urlencode 'ep_ids=780019' \ + --data-urlencode 'article_ids=1' \ + --data-urlencode 'build=0' \ + --data-urlencode 'mobi_app=web' \ + -b 'SESSDATA=xxx' ```
@@ -1259,15 +1259,15 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack' \ 调用该接口会将该会话设置为已读 -**URL参数:** +**URL参数:** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| --- | --- | --- | --- | --- | -| w_sender_uid | num | 发送者mid | 必要 | 必须为自己的 mid | -| w_receiver_id | num | 接收者id | 必要 | 请求参数 `msg[receiver_type]` 为 `1` 时表示用户 mid,为 `2` 时表示粉丝团 id | -| w_dev_id | str | 设备id | 必要 | 实质上即 UUID(版本 4),**生成方式见下** | -| w_rid | str | Wbi 签名 | 必要 | 参见 [Wbi 签名](../misc/sign/wbi.md) | -| wts | str | UNIX 秒级时间戳 | 必要 | 参见 [Wbi 签名](../misc/sign/wbi.md) | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------------- | ---- | --------------- | ------ | ------------------------------------ | +| w_sender_uid | num | 发送者mid | 非必要 | 同正文参数 `msg[sender_uid]` | +| w_receiver_id | num | 接收者id | 非必要 | 同正文参数 `msg[receiver_id]` | +| w_dev_id | str | 设备id | 非必要 | 同正文参数 `msg[dev_id]` | +| w_rid | str | Wbi 签名 | 非必要 | 参见 [Wbi 签名](../misc/sign/wbi.md) | +| wts | str | UNIX 秒级时间戳 | 非必要 | 参见 [Wbi 签名](../misc/sign/wbi.md) | **正文参数(application/x-www-form-urlencoded):** @@ -1281,7 +1281,7 @@ curl 'https://api.vc.bilibili.com/session_svr/v1/session_svr/update_ack' \ | msg\[dev_id\] | str | 设备id | 必要 | 实质上即 UUID(版本 4),**生成方式见下** | | msg\[timestamp\] | num | 当前时间戳(秒) | 必要 | | | msg\[new_face_version\] | num | 表情包版本 | 非必要 | 提供 `0` 或者未提供本参数表示旧版表情包,此时 B 站会自动转换成新版表情包,例如 `[doge]` -> `[tv_doge]`;`1` 为新版 | -| msg\[content\] | str | 消息内容 | 必要 | 详见[私信消息类型、内容说明](private_msg_content.md) | +| msg\[content\] | str | 消息内容 | 必要 | 详见[私信消息类型、内容说明](private_msg_content.md),接受最多2000字节的内容 | | csrf_token | str | CSRF Token(位于cookie) | 必要 | | | csrf | str | CSRF Token(位于cookie) | 必要 | | | build | num | 客户端内部版本号 | 非必要 | 默认为 `0` | @@ -1327,10 +1327,10 @@ const dev_id = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (function import java.util.UUID; public class Main { - private String getDevId() { - UUID uuid = UUID.randomUUID(); - return uuid.toString(); - } + private String getDevId() { + UUID uuid = UUID.randomUUID(); + return uuid.toString(); + } } ``` diff --git a/docs/message/private_msg_content.md b/docs/message/private_msg_content.md index b07bfd4..e2af0f3 100644 --- a/docs/message/private_msg_content.md +++ b/docs/message/private_msg_content.md @@ -20,7 +20,7 @@ ```json { - "content": "Hello" + "content": "Hello" } ``` @@ -28,7 +28,7 @@ 在发送私信时,请确保下面的对象合法且 `url` 项的值为 B 站的图床 url,否则会报 21037 `图片格式不合法,不要调戏接口啦` 错误 -建议设置 `height` 与 `width` 属性,否则可能会导致消息显示异常 +建议设置 `height` 与 `width` 属性为图片的尺寸,否则可能会导致消息显示异常 根对象: @@ -47,12 +47,12 @@ ```json { - "url": "https://message.biliimg.com/bfs/im_new/c161fdf51d901c1607a15e30f10116dd425503913.jpg", - "height": 300, - "width": 300, - "imageType": "jpeg", - "original": 1, - "size": 55.443 + "url": "https://message.biliimg.com/bfs/im_new/c161fdf51d901c1607a15e30f10116dd425503913.jpg", + "height": 300, + "width": 300, + "imageType": "jpeg", + "original": 1, + "size": 55.443 } ``` @@ -100,13 +100,13 @@ ```json { - "author": "社会易姐QwQ", - "headline": "", - "id": 246551172, - "source": 5, - "thumb": "http://i2.hdslb.com/bfs/archive/14ba78056f946ece8c954a10677ef6b073edb178.jpg", - "title": "合 成 大 東 瓜", - "bvid": "BV16v411e7CW" + "author": "社会易姐QwQ", + "headline": "", + "id": 246551172, + "source": 5, + "thumb": "http://i2.hdslb.com/bfs/archive/14ba78056f946ece8c954a10677ef6b073edb178.jpg", + "title": "合 成 大 東 瓜", + "bvid": "BV16v411e7CW" } ``` @@ -150,14 +150,14 @@ ```json { - "avatar": "http://i0.hdslb.com/bfs/mall/mall/7b/dd/7bdd072290de017593791b52e937ca29.png", - "cover": "http://i0.hdslb.com/bfs/mall/mall/7b/dd/7bdd072290de017593791b52e937ca29.png", - "id": "bili91e3e7e93af281f9", - "jump_uri": "https://mall.bilibili.com/miniapp/bili91e3e7e93af281f9/pages/main?___timestamp=1689526821040&_biliFrom=about_bili_message&share_medium=android&share_source=bili_message&bbid=XU8CE838022AF6625C64B2153A3EF1E571AFF&ts=1689526821048", - "label_cover": "https://i0.hdslb.com/bfs/mall/mall/ae/0e/ae0ee4a857df5e307e1d04b5d420cb5b.png", - "label_name": "小程序", - "name": "主站测试专用小程序", - "title": "主站测试专用小程序" + "avatar": "http://i0.hdslb.com/bfs/mall/mall/7b/dd/7bdd072290de017593791b52e937ca29.png", + "cover": "http://i0.hdslb.com/bfs/mall/mall/7b/dd/7bdd072290de017593791b52e937ca29.png", + "id": "bili91e3e7e93af281f9", + "jump_uri": "https://mall.bilibili.com/miniapp/bili91e3e7e93af281f9/pages/main?___timestamp=1689526821040&_biliFrom=about_bili_message&share_medium=android&share_source=bili_message&bbid=XU8CE838022AF6625C64B2153A3EF1E571AFF&ts=1689526821048", + "label_cover": "https://i0.hdslb.com/bfs/mall/mall/ae/0e/ae0ee4a857df5e307e1d04b5d420cb5b.png", + "label_name": "小程序", + "name": "主站测试专用小程序", + "title": "主站测试专用小程序" } ``` @@ -176,12 +176,12 @@ | ----------------- | ----- | ------------- | ------------------------- | | title | str | 通知标题 | | | text | str | 通知内容 | | -| jump_text | str | 按钮1提示文字 | 若按钮1不存在则为空;若按钮1存在此项也可能为空,此时前端显示文字为 `查看详情` | +| jump_text | str | 按钮1提示文字 | 若按钮1不存在则为空;若按钮1存在,此项也可能为空,此时前端显示文字为 `查看详情` | | jump_uri | str | 按钮1跳转链接 | 若按钮1不存在则为空 | | modules | 有效时:array
无效时:null | 详细信息 | | -| jump_text_2 | str | 按钮2提示文字 | 若按钮2不存在则为空;若按钮2存在此项也可能为空,此时前端显示文字为 `查看详情` | +| jump_text_2 | str | 按钮2提示文字 | 若按钮2不存在则为空;若按钮2存在,此项也可能为空,此时前端显示文字为 `查看详情` | | jump_uri_2 | str | 按钮2跳转链接 | 若按钮2不存在则为空 | -| jump_text_3 | str | 按钮3提示文字 | 若按钮3不存在则为空;若按钮3存在此项也可能为空,此时前端显示文字为 `查看详情` | +| jump_text_3 | str | 按钮3提示文字 | 若按钮3不存在则为空;若按钮3存在,此项也可能为空,此时前端显示文字为 `查看详情` | | jump_uri_3 | str | 按钮3跳转链接 | 若按钮3不存在则为空 | | notifier | 有效时:obj
无效时:null | 发送者信息 | | | jump_uri_config | obj | 按钮1配置 | | @@ -241,44 +241,44 @@ ```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 - } + "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 + } } ``` @@ -315,17 +315,17 @@ ```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 + "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 } ``` @@ -370,19 +370,19 @@ ```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 + "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 } ``` @@ -402,9 +402,9 @@ ```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": "原神,启动!" + "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": "原神,启动!" } ``` @@ -429,12 +429,12 @@ ```json { - "author": "哔哩哔哩晚会", - "cover": "https://i1.hdslb.com/bfs/face/1b593d28fcd0cf63837c3ea80ac96d01bb85ec3b.jpg", - "desc": "主播:哔哩哔哩晚会 https://live.bilibili.com/21738461", - "source": "直播", - "title": "2023最美的夜 bilibili晚会", - "url": "https://live.bilibili.com/21738461?broadcast_type=0&is_room_feed=1&live_from=41000&share_medium=android&share_source=bili_message&bbid=XU8CE838022AF6625C64B2153A3EF1E571AFF&ts=1704038936971" + "author": "哔哩哔哩晚会", + "cover": "https://i1.hdslb.com/bfs/face/1b593d28fcd0cf63837c3ea80ac96d01bb85ec3b.jpg", + "desc": "主播:哔哩哔哩晚会 https://live.bilibili.com/21738461", + "source": "直播", + "title": "2023最美的夜 bilibili晚会", + "url": "https://live.bilibili.com/21738461?broadcast_type=0&is_room_feed=1&live_from=41000&share_medium=android&share_source=bili_message&bbid=XU8CE838022AF6625C64B2153A3EF1E571AFF&ts=1704038936971" } ``` @@ -477,42 +477,42 @@ ```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": "20万", - "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": "15万", - "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": "5万", - "icon3": 1, - "field4": "102", - "icon4": 3 - }] + "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": "20万", + "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": "15万", + "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": "5万", + "icon3": 1, + "field4": "102", + "icon4": 3 + }] } ``` @@ -522,8 +522,8 @@ 根对象: -| 字段 | 类型 | 内容 | 备注 | -| ------- | ---- | -------- | ---------------------- | +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | -------------------------- | | content | str | 提示列表 | **经过序列化后**的JSON数组 | `content`文本经JSON解析后的数组: @@ -549,7 +549,7 @@ ```json { - "content": "[{\"text\":\"对方主动回复或关注你前,最多发送1条消息\",\"color_day\":\"#9499A0\",\"color_nig\":\"#9499A0\"}]" + "content": "[{\"text\":\"对方主动回复或关注你前,最多发送1条消息\",\"color_day\":\"#9499A0\",\"color_nig\":\"#9499A0\"}]" } ``` @@ -601,10 +601,10 @@ 根对象: -| 字段 | 类型 | 内容 | 备注 | -| -------- | ---- | -------- | ---- | -| group_id | num | 粉丝团id | | -| content | str | 提示文字 | | +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | -------- | ---------- | +| group_id | num | 粉丝团id | (非必要) | +| content | str | 提示文字 | | **示例:** @@ -612,8 +612,8 @@ ```json { - "group_id": 221082140, - "content": "社会易姐QwQ的应援团开通啦 (>▽<)" + "group_id": 221082140, + "content": "社会易姐QwQ的应援团开通啦 (>▽<)" } ``` @@ -621,7 +621,7 @@ ```json { - "group_id": 221082140, - "content": "欢迎wuziqian211入群" + "group_id": 221082140, + "content": "欢迎wuziqian211入群" } ``` diff --git a/docs/user/info.md b/docs/user/info.md index 09bf4b6..3532f1b 100644 --- a/docs/user/info.md +++ b/docs/user/info.md @@ -318,7 +318,7 @@ | 字段 | 类型 | 内容 | 备注 | | -------- | ---- | ---------------- | ---------------- | | show | bool | 是否显示充电按钮 | | -| state | num | 充电功能开启状态 | -1:未开通充电功能
1:已开通自定义充电
2:已开通包月、自定义充电
3:已开通高档、自定义充电 | +| state | num | 充电功能开启状态 | -1:未开通充电功能
1:已开通自定义充电
2:已开通包月、自定义充电
3:已开通包月高档、自定义充电 | | title | str | 充电按钮显示文字 | 空字符串或 `充电` 或 `充电中` | | icon | str | 充电图标 | | | jump_url | str | 跳转url | |