diff --git a/README.md b/README.md index 25ba648..bde34c4 100644 --- a/README.md +++ b/README.md @@ -203,7 +203,7 @@ B站 API 采用 C/S 结构,大多数接口为 REST API 和 gRPC,少部分接 - [x] [B 币方式充电](docs/electric/Bcoin.md) - [x] [微信 & 支付宝方式充电](docs/electric/WeChat&Alipay.md) - [x] [充电留言](docs/electric/charge_msg.md) - - [x] [充电列表](docs/electric/charge_list.md) + - [x] [充电列表](docs/electric/charge_list.md) - [ ] [动态](docs/dynamic) - [ ] [获取动态列表](docs/dynamic/all.md) - [ ] [获取用户空间动态](docs/dynamic/space.md) diff --git a/docs/electric/Bcoin.md b/docs/electric/Bcoin.md index 0da4677..970d1bc 100644 --- a/docs/electric/Bcoin.md +++ b/docs/electric/Bcoin.md @@ -31,7 +31,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0:成功(并不代表充电成功)
-101:账号未登录
-111:csrf校验失败
-400:请求错误 | +| code | num | 返回值 | 0:成功(并不代表充电成功)
-101:账号未登录
-111:csrf校验失败
-400:请求错误
-500:服务器错误 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | | | data | obj | 信息本体 | | @@ -72,17 +72,17 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \ ```json { - "code":0, - "message":"0", - "ttl":1, - "data":{ - "mid":293793435, - "up_mid":293793435, - "order_no":"BPRG5CEC3VUPOOANA540", - "bp_num":2, - "exp":"2", - "status":4, - "msg":"" + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 293793435, + "up_mid": 293793435, + "order_no": "BPRG5CEC3VUPOOANA540", + "bp_num": 2, + "exp": "2", + "status": 4, + "msg": "" } } ``` @@ -108,17 +108,17 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \ ```json { - "code":0, - "message":"0", - "ttl":1, - "data":{ - "mid":0, - "up_mid":0, - "order_no":"", - "bp_num":"0", - "exp":0, - "status":-2, - "msg":"elec raw order create failed: 88201" + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 0, + "up_mid": 0, + "order_no": "", + "bp_num": "0", + "exp": 0, + "status": -2, + "msg": "elec raw order create failed: 88201" } } ``` @@ -145,17 +145,17 @@ curl 'https://api.bilibili.com/x/ugcpay/web/v2/trade/elec/pay/quick' \ ```json { - "code":0, - "message":"0", - "ttl":1, - "data":{ - "mid":0, - "up_mid":0, - "order_no":"", - "bp_num":"0", - "exp":0, - "status":-4, - "msg":"bp.to.battery http failed, invalid args, errNo=800409904: B 币余额不足" + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 0, + "up_mid": 0, + "order_no": "", + "bp_num": "0", + "exp": 0, + "status": -4, + "msg": "bp.to.battery http failed, invalid args, errNo=800409904: B 币余额不足" } } ``` @@ -232,17 +232,17 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/quick' \ ```json { - "code":0, - "message":"0", - "ttl":1, - "data":{ - "mid":293793435, - "up_mid":293793435, - "order_no":"BPRG5CEC3VUPOOANA540", - "elec_num":20, - "exp":2, - "status":4, - "msg":"" + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 293793435, + "up_mid": 293793435, + "order_no": "BPRG5CEC3VUPOOANA540", + "elec_num": 20, + "exp": 2, + "status": 4, + "msg": "" } } ``` @@ -268,17 +268,17 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/quick' \ ```json { - "code":0, - "message":"0", - "ttl":1, - "data":{ - "mid":0, - "up_mid":0, - "order_no":"", - "elec_num":0, - "exp":0, - "status":-2, - "msg":"elec raw order create failed: 88201" + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 0, + "up_mid": 0, + "order_no": "", + "elec_num": 0, + "exp": 0, + "status": -2, + "msg": "elec raw order create failed: 88201" } } ``` @@ -304,17 +304,17 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/quick' \ ```json { - "code":0, - "message":"0", - "ttl":1, - "data":{ - "mid":0, - "up_mid":0, - "order_no":"", - "elec_num":0, - "exp":0, - "status":-4, - "msg":"bp.to.battery http failed, invalid args, errNo=800409904: B 币余额不足" + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 0, + "up_mid": 0, + "order_no": "", + "elec_num": 0, + "exp": 0, + "status": -4, + "msg": "bp.to.battery http failed, invalid args, errNo=800409904: B 币余额不足" } } ``` diff --git a/docs/electric/WeChat&Alipay.md b/docs/electric/WeChat&Alipay.md index 1885a82..2d2e193 100644 --- a/docs/electric/WeChat&Alipay.md +++ b/docs/electric/WeChat&Alipay.md @@ -23,9 +23,9 @@ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------------------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ | -| bp_num | num | 充电B币数量 | 必要 | 必须在2-9999之间 | -| up_mid | num | 充电对象用户mid | 必要 | | +| bp_num | num | 充电B币数量 | 必要 | 必须在2-9999之间 | | is_bp_remains_prior | bool | 是否优先扣除B币 | 必要 | true:是
false:否
在B币不足时剩余的部分利用支付平台支付 | +| up_mid | num | 充电对象用户mid | 必要 | | | otype | str | 充电来源 | 必要 | up:空间充电
archive:视频充电 | | oid | num | 充电来源代码 | 必要 | 空间充电:充电对象用户mid
视频充电:稿件avid | | csrf | str | CSRF Token(位于cookie) | 必要 | | @@ -118,7 +118,7 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/qr_code/create' \ **示例:** -当申请到的支付二维码未被扫描时,`data`.`ststus`的值为`2` +当申请到的支付二维码未被扫描时,`data`.`status`的值为`2` ```shell curl -G 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status' \ @@ -131,20 +131,20 @@ curl -G 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status' \ ```json { - "code":0, - "message":"0", - "ttl":1, - "data":{ - "qr_token":"c7cbdc47fc424cd18f2146db653597b8", - "mid":293793435, - "status":2 + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "qr_token": "c7cbdc47fc424cd18f2146db653597b8", + "mid": 293793435, + "status": 2 } } ``` -当申请到的支付二维码已扫描但未确认时,`data`.`ststus`的值为`3` +当申请到的支付二维码已扫描但未确认时,`data`.`status`的值为`3` ```shell curl -G 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status' \ @@ -157,20 +157,20 @@ curl -G 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status' \ ```json { - "code":0, - "message":"0", - "ttl":1, - "data":{ - "qr_token":"c7cbdc47fc424cd18f2146db653597b8", - "mid":293793435, - "status":3 + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "qr_token": "c7cbdc47fc424cd18f2146db653597b8", + "mid": 293793435, + "status": 3 } } ``` -成功支付后,`data`.`ststus`的值为`1`,且`data`.`order_no`存在留言token +成功支付后,`data`.`status`的值为`1`,且`data`.`order_no`存在留言token ```shell curl -G 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status' \ @@ -183,14 +183,14 @@ curl -G 'https://api.bilibili.com/x/ugcpay/trade/elec/pay/order/status' \ ```json { - "code":0, - "message":"0", - "ttl":1, - "data":{ - "qr_token":"bd649c836c524550bfe22a369334fc05", - "order_no":"BPTD36U3KP82I31RSSLG", - "mid":293793435, - "status":1 + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "qr_token": "bd649c836c524550bfe22a369334fc05", + "order_no": "BPTD36U3KP82I31RSSLG", + "mid": 293793435, + "status": 1 } } ``` diff --git a/docs/electric/charge_list.md b/docs/electric/charge_list.md index e4d6216..6dad46d 100644 --- a/docs/electric/charge_list.md +++ b/docs/electric/charge_list.md @@ -42,7 +42,6 @@ | 0 | obj | 充电用户1 | | | n | obj | 充电用户(n+1) | 按照充电排名排列 | | …… | obj | …… | …… | -| 29 | obj | 充电用户30 | 最后一项 | `data`中的`list`数组中的对象: @@ -60,11 +59,11 @@ `list`数组中的对象中的`vip_info`对象: -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ---- | -------------------- | ----------------------------------------- | -| vipDueMsec | num | 大会员过期时间(?) | 恒为0 | -| vipStatus | num | 大会员状态 | 0:无
1:有 | -| vipType | num | 大会员类型 | 0:无
1:月会员
2:年会员及以上 | +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ---- | -------------- | ----- | +| vipDueMsec | num | 大会员过期时间 | 恒为0 | +| vipStatus | num | 大会员状态 | 包月充电时恒为0
自定义充电:
0:无
1:有 | +| vipType | num | 大会员类型 | 包月充电时恒为0
自定义充电:
0:无
1:月大会员
2:年度及以上大会员 | **示例:** @@ -85,56 +84,33 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \ "message": "", "ttl": 0, "data": { - "count": 397, + "count": 8521, "list": [ { - "uname": "Mars韩笑", - "avatar": "https://i1.hdslb.com/bfs/face/a46599fa41cac672eda677e334f0be93cca02f1f.jpg", + "uname": "云梦澡堂", + "avatar": "https://i1.hdslb.com/bfs/face/6589df5fdac0f80593f6a86e4d88dc08e25df3d2.jpg", "mid": 53456, - "pay_mid": 5683462, + "pay_mid": 1555775947, "rank": 1, "trend_type": 0, - "vip_info": { - "vipDueMsec": 0, - "vipStatus": 1, - "vipType": 2 - }, - "message": "你真棒,你是奇迹!(Warma真的是太棒了!", + "vip_info": { "vipDueMsec": 0, "vipStatus": 0, "vipType": 0 }, + "message": "", "message_hidden": 0 }, { - "uname": "愚星-", - "avatar": "https://i1.hdslb.com/bfs/face/7e4a8b150567a20a1b075aa3894dd3674a1e6ebe.jpg", + "uname": "在下小天子", + "avatar": "https://i1.hdslb.com/bfs/face/a3bfbe6186889bb50dcd87c1156d07a70227a25b.jpg", "mid": 53456, - "pay_mid": 382630072, + "pay_mid": 508630801, "rank": 2, "trend_type": 0, - "vip_info": { - "vipDueMsec": 0, - "vipStatus": 1, - "vipType": 1 - }, - "message": "感谢您给我带来的快乐!我的人生遇见你是我的荣幸!!", - "message_hidden": 0 - }, - { - "uname": "なか酱", - "avatar": "https://i0.hdslb.com/bfs/face/d4b74091d7f1c336399625dc062ddc93d676bcdc.jpg", - "mid": 53456, - "pay_mid": 446080731, - "rank": 3, - "trend_type": 0, - "vip_info": { - "vipDueMsec": 0, - "vipStatus": 1, - "vipType": 2 - }, + "vip_info": { "vipDueMsec": 0, "vipStatus": 0, "vipType": 0 }, "message": "", "message_hidden": 0 } ], - "total_count": 27291, - "total": 27291, + "total_count": 41919, + "total": 41919, "special_day": 0 } } @@ -169,22 +145,41 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \ `data`对象: -| 字段 | 类型 | 内容 | 备注 | -| ----------- | ----- | ---------------- | ------------ | -| show_info | obj | 展示选项 | | -| av_count | num | 目标视频充电人数 | | -| count | num | 本月充电人数 | | -| total_count | num | 总计充电人数 | | -| special_day | num | 0 | 作用尚不明确 | -| display_num | num | 0 | 作用尚不明确 | -| list | array | 本月充电用户列表 | | +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ----- | ---------------- | ------------ | +| show_info | obj | 展示选项 | | +| av_count | num | 目标视频充电人数 | | +| count | num | 本月充电人数 | | +| total_count | num | 总计充电人数 | | +| special_day | num | 0 | 作用尚不明确 | +| display_num | num | 0 | 作用尚不明确 | +| cnt_priv_type | num | 0 | 作用尚不明确 | +| list | array | 本月充电用户列表 | | `data`中的`show_info`对象: -| 字段 | 类型 | 内容 | 备注 | -| ----- | ---- | ------------------------ | ----------------------------- | -| show | bool | 是否展示视频充电鸣谢名单 | false:不展示
true:展示 | -| state | num | 0 | | +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ---- | ------------------------ | ---------------- | +| show | bool | 是否展示视频充电鸣谢名单 | | +| state | num | 充电功能开启状态 | -1:未开通充电功能
1:已开通自定义充电
2:已开通包月、自定义充电
3:已开通高档、自定义充电 | +| title | str | 充电按钮显示文字 | 空字符串或 `充电` 或 `充电中` | +| jump_url | str | 跳转url | | +| icon | str | 充电图标 | | +| high_level | obj | 高档充电信息 | | + +`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 | | | `data`中的`list`数组: @@ -193,7 +188,6 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \ | 0 | obj | 充电用户1 | | | n | obj | 充电用户(n+1) | 按照充电排名排列 | | …… | obj | …… | …… | -| 29 | obj | 充电用户30 | 最后一项 | `data`中的`list`数组中的对象: @@ -211,11 +205,11 @@ curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up' \ `data`中的`list`数组中的`vip_info`对象: -| 字段 | 类型 | 内容 | 备注 | -| ---------- | ---- | ---------- | ----------------------------------- | -| vipType | num | 大会员类型 | 0:无
1:月会员
2:年会员 | -| vipDueMsec | num | 0 | 作用尚不明确 | -| vipStatus | num | 大会员状态 | 0:无
1:有 | +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ---- | -------------- | ----- | +| vipType | num | 大会员类型 | 包月充电时恒为0
自定义充电:
0:无
1:月大会员
2:年度及以上大会员 | +| vipDueMsec | num | 大会员过期时间 | 恒为0 | +| vipStatus | num | 大会员状态 | 包月充电时恒为0
自定义充电:
0:无
1:有 | **示例:** @@ -248,45 +242,51 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \ "data": { "show_info": { "show": true, - "state": 0 + "state": 2, + "title": "充电", + "jump_url": "https://www.bilibili.com/h5/upower/index?mid=53456&navhide=1&prePage=video&oid=967773538", + "icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png", + "high_level": { + "privilege_type": 0, + "title": "", + "sub_title": "", + "show_button": false, + "button_text": "", + "jump_url": { "up_link": "", "paywall_link": "", "previewbar_link": "" }, + "intro": "", + "open": false, + "new": false + } }, "av_count": 0, "count": 0, - "total_count": 19422, + "total_count": 41919, "special_day": 0, "display_num": 0, + "cnt_priv_type": 0, "list": [ { "mid": 53456, - "pay_mid": 1216085164, + "pay_mid": 1555775947, "rank": 1, - "uname": "JZ72", - "avatar": "http://i1.hdslb.com/bfs/face/3d741682fafc286999b5e8089a844ae4f46651fe.jpg", - "message": "Warma YYDS ", + "uname": "云梦澡堂", + "avatar": "https://i1.hdslb.com/bfs/face/6589df5fdac0f80593f6a86e4d88dc08e25df3d2.jpg", + "message": "", "msg_deleted": 0, - "vip_info": { - "vipType": 2, - "vipDueMsec": 0, - "vipStatus": 1 - }, + "vip_info": { "vipType": 0, "vipDueMsec": 0, "vipStatus": 0 }, "trend_type": 0 }, { "mid": 53456, - "pay_mid": 305858373, + "pay_mid": 508630801, "rank": 2, - "uname": "适应性神经系统", - "avatar": "http://i0.hdslb.com/bfs/face/2ad38dec879f66c32b5e5cb1750cb3f3e446bf91.jpg", + "uname": "在下小天子", + "avatar": "https://i1.hdslb.com/bfs/face/a3bfbe6186889bb50dcd87c1156d07a70227a25b.jpg", "message": "", "msg_deleted": 0, - "vip_info": { - "vipType": 1, - "vipDueMsec": 0, - "vipStatus": 0 - }, + "vip_info": { "vipType": 0, "vipDueMsec": 0, "vipStatus": 0 }, "trend_type": 0 - }, - ...... + } ] } } @@ -307,7 +307,7 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ----------- | ---- | -------- | ------ | ------------------- | | currentPage | num | 页数 | 必要 | | -| pageSize | num | 分页大小 | 必要 | 取值范围[1,50] | +| pageSize | num | 分页大小 | 必要 | 取值范围\[1,50\] | | customerId | num | (?) | 必要 | 目前为固定值:10026 | | beginTime | str | 开始日期 | 非必要 | yyyy-MM-dd | | endTime | str | 结束日期 | 非必要 | yyyy-MM-dd | @@ -318,12 +318,12 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | --------------------------- | -| code | num | 返回值 | 0:成功
800501007:user not login
800501008:内部错误
800501011:请求参数有误 | +| code | num | 返回值 | 0:成功
800501007:user not login
800501008:内部错误
800501011:请求参数有误 | | errno | num | | | | msg | str | | | | showMsg | str | | | -| success | bool | | | | data | obj | 信息本体 | | +| success | bool | | | `data`对象: @@ -342,18 +342,6 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \ | totalCount | num | 记录总数 | | | totalPage | num | 总页数 | | -`config`数组中的对象: - -| 字段 | 类型 | 内容 | 备注 | -| ----------------- | ---- | ---- | ---------- | -| mid | null | | 总是为null | -| name | null | | 总是为null | -| avatar | null | | 总是为null | -| originalThirdCoin | null | | 总是为null | -| brokerage | null | | 总是为null | -| remark | null | | 总是为null | -| ctime | null | | 总是为null | - `result`数组中的对象: | 字段 | 类型 | 内容 | 备注 | @@ -366,6 +354,18 @@ curl -G 'https://api.bilibili.com/x/web-interface/elec/show' \ | remark | str | 充电渠道 | Web/安卓/iOS | | ctime | str | 充电时间 | yyyy-MM-dd HH:mm:ss | +`config`数组中的对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----------------- | ---- | ---- | ---------- | +| mid | null | | 总是为null | +| name | null | | 总是为null | +| avatar | null | | 总是为null | +| originalThirdCoin | null | | 总是为null | +| brokerage | null | | 总是为null | +| remark | null | | 总是为null | +| ctime | null | | 总是为null | + **示例:** ```shell diff --git a/docs/electric/charge_msg.md b/docs/electric/charge_msg.md index d9b8abf..534fe9f 100644 --- a/docs/electric/charge_msg.md +++ b/docs/electric/charge_msg.md @@ -8,7 +8,7 @@ 认证方式:Cookie(SESSDATA) -**正文参数( application/x-www-form-urlencoded ):** +**正文参数(application/x-www-form-urlencoded):** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | -------- | ---- | ------------------------ | ------ | ---- | @@ -32,10 +32,10 @@ ```shell curl 'https://api.bilibili.com/x/ugcpay/trade/elec/message' \ ---data-urlencode 'order_id=BPRG5CEC3VUPOOANA540' \ ---data-urlencode 'message=支持一下大佬' \ ---data-urlencode 'csrf=xxx' \ --b 'SESSDATA=xxx' + --data-urlencode 'order_id=BPRG5CEC3VUPOOANA540' \ + --data-urlencode 'message=支持一下大佬' \ + --data-urlencode 'csrf=xxx' \ + -b 'SESSDATA=xxx' ```
@@ -43,9 +43,9 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/message' \ ```json { - "code":0, - "message":"0", - "ttl":1 + "code": 0, + "message": "0", + "ttl": 1 } ``` @@ -55,71 +55,71 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/message' \ > https://member.bilibili.com/x/web/elec/remark/list -*请求方式:GET* +*请求方式:GET* 认证方式:Cookie(SESSDATA) **url参数:** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | ------------ | ------------ | ------------------ | -| begin | str | 起始日期 | | 默认2016-01-01 | -| end | str | 结束日期 | | 默认2050-01-01 | -| pn | str | 页数 | | | -| ps | str | 分页大小 | | 取值范围[1,12] | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | --------- | ------ | ---------------- | +| begin | str | 起始日期 | 非必要 | 默认2016-01-01 | +| end | str | 结束日期 | 非必要 | 默认2050-01-01 | +| pn | str | 页数 | 非必要 | | +| ps | str | 分页大小 | 非必要 | 取值范围\[1,12\] | **json回复:** 根对象: -| 字段 | 类型 | 内容 | 备注 | -| ------- | ---- | -------- | --------------------------- | -| code | num | 返回值 | 0:成功
-101:账号未登录| -| msg | str | 0 | | -| ttl | num | 1 | | -| data | obj | 信息本体 | | +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ----------------------------- | +| code | num | 返回值 | 0:成功
-101:账号未登录 | +| msg | str | 错误信息 | 成功时为`0` | +| ttl | num | 1 | | +| data | obj | 信息本体 | | `data`对象: -| 字段 | 类型 | 内容 | 备注 | -| -------- | ----- | ------ | ---- | -| page | obj | 分页信息 | | -| list | array | 信息本体 | | - -`page`对象: - -| 字段 | 类型 | 内容 | 备注 | -| -------- | ----- | ------ | ---- | -| current | num | 当前页数 | | -| size | num | 当前分页大小 | | -| total | num | 记录总数 | | +| 字段 | 类型 | 内容 | 备注 | +| ----- | ----- | -------- | ---- | +| list | array | 信息本体 | | +| pager | obj | 分页信息 | | `list`数组中的对象: -| 字段 | 类型 | 内容 | 备注 | -| -------- | ----- | ------ | ---- | -| aid | num | | | -| bvid | str | | | -| id | num | 留言记录id | | -| mid | num | | | -| reply_mid | num | 0| | -| elec_num | num | 0 | | -| state | num | UP是否已经回复这条留言 | 0:未回复
1:已回复 | -| msg | str | 留言信息 | | -| aname | str | 空 | | -| uname | str |空 | | -| avator | str | 空 | | -| reply_name | str | 空 | | -| reply_avator | str | 空 | | -| reply_msg | str | 空 | | -| ctime | num | 留言时间 | 毫秒级时间戳 | -| reply_time | num | 0 | | +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ---- | ---------------------- | ---- | +| aid | num | | | +| bvid | str | | | +| id | num | 留言记录id | | +| mid | num | 0 | | +| reply_mid | num | 0 | | +| elec_num | num | 0 | | +| state | num | UP是否已经回复这条留言 | 0:未回复
1:已回复 | +| msg | str | 留言信息 | | +| aname | str | 空 | | +| uname | str | 空 | | +| avator | str | 空 | | +| reply_name | str | 空 | | +| reply_avator | str | 空 | | +| reply_msg | str | 空 | | +| ctime | num | 留言时间 | 毫秒级时间戳 | +| reply_time | num | 0 | | + +`pager`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | ------------ | ---- | +| current | num | 当前页数 | | +| size | num | 当前分页大小 | | +| total | num | 记录总数 | | **示例:** ```shell -curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/list?begin=2016-01-01&end=2050-01-01&pn=1&ps=10' \ --H 'Cookie: SESSDATA=xxx;' +curl 'https://member.bilibili.com/x/web/elec/remark/list?begin=2016-01-01&end=2050-01-01&pn=1&ps=10' \ + -b 'SESSDATA=xxx' ```
@@ -166,51 +166,53 @@ curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/list?begin=2016-01 > https://member.bilibili.com/x/web/elec/remark/detail +*请求方式:GET* + 认证方式:Cookie(SESSDATA) **url参数:** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| -------- | ---- | -------- | ------ | -------------------------------- | -| id | num | 留言id | 必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | -------- | ------ | ---- | +| id | num | 留言id | 必要 | | **json回复:** 根对象: -| 字段 | 类型 | 内容 | 备注 | -| ------- | ---- | -------- | --------------------------- | -| code | num | 返回值 | 0:成功
-101:账号未登录
-400:请求错误| -| message | str | 0 | | -| ttl | num | 1 | | -| data | obj | 信息本体 | | +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------- | +| code | num | 返回值 | 0:成功
-101:账号未登录
-400:请求错误 | +| message | str | 错误信息 | 成功时为 `0` | +| ttl | num | 1 | | +| data | obj | 信息本体 | | `data`对象: -| 字段 | 类型 | 内容 | 备注 | -| -------- | ----- | ------ | ---- | -| aid | num | | | -| bvid | str | | | -| id | num | 留言id | | -| mid | num | 留言者uid(充电用户) | | -| reply_mid | num | UP主uid | | -| elec_num | num | 0 | | -| state | num | UP是否已经回复这条留言 | 0:未回复
1:已回复 | -| msg | str | 留言内容 | | -| aname | str | 空 | | -| uname | str | 留言者用户名 | | -| avator | str | 留言者头像 | | -| reply_name | str | UP主用户名 | | -| reply_avator | str | UP主头像 | | -| reply_msg | str | 回复内容 | | -| ctime | num | 留言时间 | 毫秒级时间戳 | -| reply_time | num | 回复时间 | 毫秒级时间戳 | +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ---- | ---------------------- | ---- | +| aid | num | | | +| bvid | str | | | +| id | num | 留言id | | +| mid | num | 留言者mid(充电用户) | | +| reply_mid | num | UP主mid | | +| elec_num | num | 0 | | +| state | num | UP是否已经回复这条留言 | 0:未回复
1:已回复 | +| msg | str | 留言内容 | | +| aname | str | 空 | | +| uname | str | 留言者用户名 | | +| avator | str | 留言者头像 | | +| reply_name | str | UP主用户名 | | +| reply_avator | str | UP主头像 | | +| reply_msg | str | 回复内容 | | +| ctime | num | 留言时间 | 毫秒级时间戳 | +| reply_time | num | 回复时间 | 毫秒级时间戳 | **示例:** ```shell -curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/detail?id=6507563' \ --H 'cookie: SESSDATA=xxx' +curl 'https://member.bilibili.com/x/web/elec/remark/detail?id=6507563' \ + -b 'SESSDATA=xxx' ```
@@ -252,13 +254,13 @@ curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/detail?id=6507563' 认证方式:Cookie(SESSDATA) -**正文参数( application/x-www-form-urlencoded ):** +**正文参数(application/x-www-form-urlencoded):** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------------ | ------ | ------------------------ | -------------- | ------------------------------------------------------------ | -| csrf | str | csrf | 必要 | | -| id | num | 留言id | 必要 | | -| msg | str | 回复信息 | | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | -------- | ------ | ---- | +| csrf | str | csrf | 必要 | | +| id | num | 留言id | 必要 | | +| msg | str | 回复信息 | 必要 | | **json回复:** @@ -266,19 +268,19 @@ curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/detail?id=6507563' | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf 校验失败
-400:请求错误20004:充电服务异常
| -| message | str | 错误信息 | | +| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf 校验失败
-400:请求错误
20004:充电服务异常 | +| message | str | 错误信息 | | | ttl | num | 1 | | +| data | num | 数据本体 | 1:成功
2:失败 | **示例:** ```shell -curl -L -X POST 'https://member.bilibili.com/x/web/elec/remark/reply' \ --H 'cookie: SESSDATA=xxx' \ --H 'Content-Type: application/x-www-form-urlencoded' \ ---data-urlencode 'csrf=xxx' \ ---data-urlencode 'id=6258929' \ ---data-urlencode 'msg=( ̄3 ̄)' +curl 'https://member.bilibili.com/x/web/elec/remark/reply' \ + -b 'SESSDATA=xxx' \ + --data-urlencode 'csrf=xxx' \ + --data-urlencode 'id=6258929' \ + --data-urlencode 'msg=( ̄3 ̄)' ```
diff --git a/docs/electric/monthly.md b/docs/electric/monthly.md index d4fc2b4..2a51de1 100644 --- a/docs/electric/monthly.md +++ b/docs/electric/monthly.md @@ -49,13 +49,13 @@ 数组`list`中的对象: -| 字段 | 类型 | 内容 | 备注 | -| --------- | ----- | --------------- | ------ | -| up_uid | num | 充电UP主mid | | -| user_name | str | 充电UP主昵称 | | -| user_face | str | 充电UP主头像url | | -| item | array | 充电详情 | | -| start | num | 开始充电时间 | 时间戳 | +| 字段 | 类型 | 内容 | 备注 | +| --------- | ----- | --------------- | ---------- | +| up_uid | num | 充电UP主mid | | +| user_name | str | 充电UP主昵称 | | +| user_face | str | 充电UP主头像url | | +| item | array | 充电详情 | | +| start | num | 开始充电时间 | 秒级时间戳 | 数组`list`中的对象中的`item`数组: @@ -67,10 +67,10 @@ | 字段 | 类型 | 内容 | 备注 | | -------------- | --------------------------------------------- | ---------------- | ---------------- | -| privilege_type | num | 10(?) | **作用尚不明确** | +| privilege_type | num | 充电类型 | 10:普通包月充电
20:高档充电 | | icon | str | 充电图标 | | | name | str | `包月充电` | | -| expire_time | num | 充电过期时间 | 时间戳 | +| expire_time | num | 充电过期时间 | 秒级时间戳 | | renew | 开启自动续费时:obj
关闭自动续费时:null | 充电自动续费详情 | | 数组`item`中的对象中的`renew`对象: @@ -81,8 +81,8 @@ | ruid | num | UP主的mid | | | goods_id | num | 充电类型 | 172:一个月
173:连续包月
174:连续包年 | | status | num | 充电状态 | 1 | -| next_execute_time | num | 下次续费时间 | 时间戳 | -| signed_time | num | 签约时间 | 时间戳 | +| next_execute_time | num | 下次续费时间 | 秒级时间戳 | +| signed_time | num | 签约时间 | 秒级时间戳 | | signed_price | num | 下次续费金额 | 单位为千分之一元人民币 | | pay_channel | num | 签约平台 | 2:微信支付
4:支付宝 | | period | num | 下次充电天数 | | @@ -466,7 +466,7 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ | nickname | str | UP主昵称 | | | avatar | str | UP主头像url | | | type | num | UP主认证类型 | -1:无
0:UP主认证
1:机构认证 | -| title | str | UP主认证信息 | | +| title | str | UP主认证文字 | | `data`中的`rank_info`数组: @@ -476,7 +476,7 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ | n | obj | 用户(n+1) | 按照充电排名排列 | | …… | obj | …… | …… | -数组`rank_info`中的对象: +`rank_info`数组中的对象: | 字段 | 类型 | 内容 | 备注 | | ----------- | ---- | ---------------- | ----- | @@ -497,14 +497,13 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ | avatar | str | 用户头像url | | | rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 | | day | num | 包月充电天数 | | -| expire_at | num | 包月充电过期时间 | 时间戳,若从未给UP主包月充电为0 | +| expire_at | num | 包月充电过期时间 | 秒级时间戳,若从未给UP主包月充电为0 | | remain_days | num | 未过期时:剩余天数
已过期且之前给UP主包月充电过:自过期以来的天数 | | **示例:** 获取给`mid=293793435`包月充电的用户排名 - ```shell curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \ --data-urlencode 'up_mid=293793435' \ diff --git a/docs/user/info.md b/docs/user/info.md index 58c4169..a16c55f 100644 --- a/docs/user/info.md +++ b/docs/user/info.md @@ -65,8 +65,8 @@ | birthday | str | 生日 | MM-DD
如设置隐私为空 | | school | obj | 学校 | | | profession | obj | 专业资质信息 | | -| tags | null | 个人标签 | | -| series | obj | | | +| tags | 有效时:array
无效时:null | 个人标签 | | +| series | obj | (?) | | | is_senior_member | num | 是否为硬核会员 | 0:否
1:是 | | mcn_info | null | (?) | | | gaia_res_type | num | (?) | | @@ -74,11 +74,13 @@ | is_risk | bool | (?) | | | elec | obj | 充电信息 | | | contract | obj | 是否显示老粉计划 | | +| certificate_show | bool | (?) | | +| name_render | 有效时:obj
无效时:null | 昵称渲染信息 | | `rank`示例 | UID | rank | -|-----------|-------| +| --------- | ----- | | 2 | 20000 | | 16765 | 20000 | | 15773384 | 20000 | @@ -105,7 +107,7 @@ `profession`示例 | UID | -|------------| +| ---------- | | 654391 | | 1440295 | | 1785155 | @@ -137,6 +139,8 @@ | avatar_subscript_url | str | 大会员角标地址 | | | tv_vip_status | num | 电视大会员状态 | 0:未开通 | | tv_vip_pay_type | num | 电视大会员支付类型 | | +| tv_due_date | num | 电视大会员过期时间 | 秒级时间戳 | +| avatar_icon | obj | 大会员角标信息 | | `vip`中的`label`对象: @@ -155,6 +159,12 @@ | img_label_uri_hans_static | str | 大会员牌子图片 | 简体版 | | img_label_uri_hant_static | str | 大会员牌子图片 | 繁体版 | +`vip`中的`avatar_icon`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ---- | ------ | ------------ | +| icon_type | num | (?) | 作用尚不明确 | +| icon_resource | obj | (?) | 作用尚不明确 | `data`中的`pendant`对象: @@ -162,25 +172,26 @@ **动态头像框的`image`为png静态图片,`image_enhance`为webp动态图片,`image_enhance_frame`为png逐帧序列** -| 字段 | 类型 | 内容 | 备注 | -|---------------------|-----|--------------|------------| -| pid | num | 头像框id | | -| name | str | 头像框名称 | | -| image | str | 头像框图片url | | -| expire | num | 过期时间 | 此接口返回恒为`0` | -| image_enhance | str | 头像框图片url | | -| image_enhance_frame | str | 头像框图片逐帧序列url | | +| 字段 | 类型 | 内容 | 备注 | +| ------------------- | ---- | --------------------- | ----------------- | +| pid | num | 头像框id | | +| name | str | 头像框名称 | | +| image | str | 头像框图片url | | +| expire | num | 过期时间 | 此接口返回恒为`0` | +| image_enhance | str | 头像框图片url | | +| image_enhance_frame | str | 头像框图片逐帧序列url | | +| n_pid | num | 新版头像框id | | `data`中的`nameplate`对象: -| 字段 | 类型 | 内容 | 备注 | -|-------------|-----|---------|-----| -| nid | num | 勋章id | | -| name | str | 勋章名称 | | -| image | str | 勋章图标 | | -| image_small | str | 勋章图标(小) | | -| level | str | 勋章等级 | | -| condition | str | 获取条件 | | +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | -------------- | ---- | +| nid | num | 勋章id | | +| name | str | 勋章名称 | | +| image | str | 勋章图标 | | +| image_small | str | 勋章图标(小) | | +| level | str | 勋章等级 | | +| condition | str | 获取条件 | | `data`中的`fans_medal`对象: @@ -298,19 +309,19 @@ `data`中的`elec`对象: -| 字段 | 类型 | 内容 | 备注 | -|-----------|-----|-----|-----| -| show_info | obj | | | +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---- | -------------- | ---- | +| show_info | obj | 显示的充电信息 | | `elec`中的`show_info`对象: -| 字段 | 类型 | 内容 | 备注 | -|----------|------|---------|------------------| -| show | bool | 是否开通了充电 | | -| state | num | 状态 | -1:未开通
1:已开通 | -| title | str | `空串` | | -| icon | str | `空串` | | -| jump_url | str | `空串` | | +| 字段 | 类型 | 内容 | 备注 | +| -------- | ---- | ---------------- | ---------------- | +| show | bool | 是否显示充电按钮 | | +| state | num | 充电功能开启状态 | -1:未开通充电功能
1:已开通自定义充电
2:已开通包月、自定义充电
3:已开通高档、自定义充电 | +| title | str | 充电按钮显示文字 | 空字符串或 `充电` 或 `充电中` | +| icon | str | 充电图标 | | +| jump_url | str | 跳转url | | `data`中的`contract`对象: @@ -359,21 +370,23 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \ "wear": true, "medal": { "uid": 2, - "target_id": 335115, - "medal_id": 45408, - "level": 21, - "medal_name": "伍千万", - "medal_color": 1725515, - "intimacy": 1980, - "next_intimacy": 2000, + "target_id": 548076, + "medal_id": 32525, + "level": 28, + "medal_name": "桜樱怪", + "medal_color": 398668, + "intimacy": 25364, + "next_intimacy": 160000, "day_limit": 250000, - "medal_color_start": 1725515, - "medal_color_end": 5414290, - "medal_color_border": 1725515, + "today_feed": 2382, + "medal_color_start": 398668, + "medal_color_end": 6850801, + "medal_color_border": 6809855, "is_lighted": 1, + "guard_level": 3, "light_status": 1, "wearing_status": 1, - "score": 50001980 + "score": 50185364 } }, "official": { @@ -385,7 +398,7 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \ "vip": { "type": 2, "status": 1, - "due_date": 3931344000000, + "due_date": 3979555200000, "vip_pay_type": 0, "theme_type": 0, "label": { @@ -407,8 +420,12 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \ "role": 7, "avatar_subscript_url": "", "tv_vip_status": 1, - "tv_vip_pay_type": 0, - "tv_due_date": 2000822400 + "tv_vip_pay_type": 1, + "tv_due_date": 2003500800, + "avatar_icon": { + "icon_type": 1, + "icon_resource": {} + } }, "pendant": { "pid": 32257, @@ -416,7 +433,8 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \ "image": "https://i2.hdslb.com/bfs/garb/item/488870931b1bba66da36d22848f0720480d3d79a.png", "expire": 0, "image_enhance": "https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp", - "image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png" + "image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png", + "n_pid": 32257 }, "nameplate": { "nid": 10, @@ -429,10 +447,11 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \ "user_honour_info": { "mid": 0, "colour": null, - "tags": [] + "tags": [], + "is_latest_100honour": 0 }, - "is_followed": true, - "top_photo": "http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png", + "is_followed": false, + "top_photo": "http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png", "theme": {}, "sys_notice": {}, "live_room": { @@ -446,9 +465,9 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \ "broadcast_type": 0, "watched_show": { "switch": true, - "num": 19, - "text_small": "19", - "text_large": "19人看过", + "num": 3, + "text_small": "3", + "text_large": "3人看过", "icon": "https://i0.hdslb.com/bfs/live/a725a9e61242ef44d764ac911691a7ce07f36c1d.png", "icon_location": "", "icon_web": "https://i0.hdslb.com/bfs/live/8d9d0f33ef8bf6f308742752d13dd0df731df19c.png" @@ -486,7 +505,9 @@ curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \ "contract": { "is_display": false, "is_follow_display": false - } + }, + "certificate_show": false, + "name_render": null } } ``` diff --git a/docs/user/relation.md b/docs/user/relation.md index 4c4f1ac..5f4bcdf 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:不能对自己进行此操作
22002:因对方隐私设置,你还不能关注
22003:关注失败,请将该用户移除黑名单之后再试
22013:账号已注销,无法完成操作
22014:已经关注用户,无法重复关注
22120:重复加入黑名单
40061:用户不存在 | +| code | num | 返回值 | 0:成功
-101:账号未登录
-102:账号被封停
-111:csrf校验失败
-400:请求错误
22001:不能对自己进行此操作
22002:因对方隐私设置,你还不能关注
22003:关注失败,请将该用户移除黑名单之后再试
22008:黑名单达到上限
22009:关注失败,已达关注上限
22013:账号已注销,无法完成操作
22014:已经关注用户,无法重复关注
22120:重复加入黑名单
40061:用户不存在 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | | @@ -2043,7 +2043,7 @@ curl 'https://api.bilibili.com/x/relation/tag/special' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0:成功
-111:csrf校验失败
-101:账号未登录
-400:请求错误
22106:该分组已经存在
22103:分组名过长 | +| code | num | 返回值 | 0:成功
-111:csrf校验失败
-101:账号未登录
-400:请求错误
22101:分组名称存在不允许的字符
22102:分组数量超过限制
22103:分组名过长
22106:该分组已经存在 | | message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | | data | obj | 信息本体 | | @@ -2104,7 +2104,7 @@ curl 'https://api.bilibili.com/x/relation/tag/create' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0:成功
-111:csrf校验失败
-101:账号未登录
-400:请求错误
22103:分组名过长
22104:该分组不存在 | +| code | num | 返回值 | 0:成功
-111:csrf校验失败
-101:账号未登录
-400:请求错误
22101:分组名称存在不允许的字符
22103:分组名过长
22104:该分组不存在 | | message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | @@ -2212,7 +2212,7 @@ curl 'https://api.bilibili.com/x/relation/tag/del' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0:成功
-111:csrf校验失败
-101:账号未登录
-400:请求错误
22104:无权限
22105:未关注 | +| code | num | 返回值 | 0:成功
-111:csrf校验失败
-101:账号未登录
-400:请求错误
22104:分组不存在
22105:未关注 | | message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | @@ -2264,7 +2264,7 @@ curl 'https://api.bilibili.com/x/relation/tags/addUsers' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0:成功
-111:csrf校验失败
-101:账号未登录
-400:请求错误
22104:无权限
22105:未关注 | +| code | num | 返回值 | 0:成功
-111:csrf校验失败
-101:账号未登录
-400:请求错误
22104:分组不存在
22105:未关注 | | message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | @@ -2317,7 +2317,7 @@ curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0:成功
-111:csrf校验失败
-101:账号未登录
-400:请求错误
22104:无权限
22105:未关注 | +| code | num | 返回值 | 0:成功
-111:csrf校验失败
-101:账号未登录
-400:请求错误
22104:分组不存在
22105:未关注 | | message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | |