diff --git a/docs/electric/monthly.md b/docs/electric/monthly.md index bf47c38..c735c90 100644 --- a/docs/electric/monthly.md +++ b/docs/electric/monthly.md @@ -2,6 +2,180 @@ +## 获取包月充电列表 + +> https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord + +*请求方式:GET* + +认证方式:Cookie(SESSDATA)或APP + +**url参数:** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | -------- | ------ | ------------------------ | +| page | num | 页码 | 必要 | | +| type | num | 充电状态 | 必要 | 1:使用中
2:已过期 | + +**json回复:** + +根对象: + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------------------- | +| code | num | 返回值 | 0:成功
-101:账号未登录
-400:请求错误
25100004:参数错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | + +`data`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | ---------------- | ---------------- | +| list | 有内容时:array
无内容时:null | 包月充电UP主列表 | 最多10个 | +| page | num | 当前页数 | | +| page_size | num | 当前分页大小 | 一般为10 | +| total_page | num | 总页数 | | +| total_num | num | 用户总数 | | +| is_more | num | 是否有更多用户 | 0:否
1:是 | + +`data`中的`list`数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---------------- | +| 0 | obj | 用户1 | | +| n | obj | 用户(n+1) | | +| …… | obj | …… | …… | + +数组`list`中的对象: + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ----- | --------------- | ------ | +| up_uid | num | 充电UP主mid | | +| user_name | str | 充电UP主昵称 | | +| user_face | str | 充电UP主头像url | | +| item | array | 充电详情 | | +| start | num | 开始充电时间 | 时间戳 | + +数组`list`中的对象中的`item`数组: + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | -------- | -------- | +| 0 | obj | 充电详情 | 套了个娃 | + +数组`item`中的对象: + +| 字段 | 类型 | 内容 | 备注 | +| -------------- | --------------------------------------------- | ---------------- | ---------------- | +| privilege_type | num | 10(?) | **作用尚不明确** | +| icon | str | 充电图标 | | +| name | str | `包月充电` | | +| expire_time | num | 充电过期时间 | 时间戳 | +| renew | 开启自动续费时:obj
关闭自动续费时:null | 充电自动续费详情 | | + +数组`item`中的对象中的`renew`对象: + +| 字段 | 类型 | 内容 | 备注 | +| ----------------- | ---- | ------------ | ------------------------------------------------- | +| uid | num | 自己的mid | | +| ruid | num | UP主的mid | | +| goods_id | num | 充电类型 | 172:一个月
173:连续包月
174:连续包年 | +| status | num | 充电状态 | 1 | +| next_execute_time | num | 下次续费时间 | 时间戳 | +| signed_time | num | 签约时间 | 时间戳 | +| signed_price | num | 下次续费金额 | 单位为千分之一元人民币 | +| pay_channel | num | 签约平台 | 2:微信支付
4:支付宝 | +| period | num | 下次充电天数 | | + +**示例:** + +获取自己正在使用的包月充电的列表 + + +```shell +curl 'https://api.live.bilibili.com/xlive/revenue/v1/guard/getChargeRecord' \ +--data-urlencode 'page=1' \ +--data-urlencode 'type=1' \ +-b 'SESSDATA=xxx' +``` + +
+查看响应示例: + +```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": "包月充电", + "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 + } + } + ], + "start": 1669183804 + }, + { + "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": "包月充电", + "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 + } + } + ], + "start": 1676033795 + } + ], + "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天; + +自己从2023-02-10 20:56:35开始给“社会易姐QwQ”包月充电,并且在2023-03-02 20:42:01在支付宝开通了连续包月充电,在2023-04-02 00:00:00的时候会自动续费5元,并继续充电31天。 + ## UP主包月充电详情 > https://api.bilibili.com/x/upower/item/detail @@ -153,7 +327,7 @@ curl 'https://api.bilibili.com/x/upower/item/detail' \ | remain_days | num | 剩余天数 | 未处于包月充电状态为-1 | | remain_less_1day | num | 剩余的天数小于1天 | 0:否
1:是
未处于包月充电状态为0 | | upower_rank | obj | 充电详情 | | -| upower_icon | str | 充电图标url | | +| upower_icon | str | 充电图标url | 仅在处于包月充电状态时有内容 | `data`中的`up_card`对象: @@ -246,12 +420,16 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ +表示自己已保持17天对“社会易姐QwQ”的包月充电,剩余15天过期。 + ## 包月充电用户排名 > https://api.bilibili.com/x/upower/up/member/rank/v2 *请求方式:GET* +认证方式:Cookie(SESSDATA)或APP + **url参数:** | 参数名 | 类型 | 内容 | 必要性 | 备注 | @@ -300,25 +478,27 @@ curl 'https://api.bilibili.com/x/upower/charge/follow/info' \ 数组`rank_info`中的对象: -| 字段 | 类型 | 内容 | 备注 | -| --------- | ---- | ---------------- | ----- | -| mid | num | 充电用户mid | | -| nickname | str | 充电用户昵称 | | -| avatar | str | 充电用户头像url | | -| rank | num | 充电用户排名 | | -| day | num | 包月充电天数 | | -| expire_at | num | 包月充电过期时间 | 恒为0 | +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ---------------- | ----- | +| mid | num | 充电用户mid | | +| nickname | str | 充电用户昵称 | | +| avatar | str | 充电用户头像url | | +| rank | num | 充电用户排名 | | +| day | num | 包月充电天数 | | +| expire_at | num | 包月充电过期时间 | 恒为0 | +| remain_days | num | 剩余天数 | 恒为0 | `data`中的`user_info`对象: -| 字段 | 类型 | 内容 | 备注 | -| --------- | ---- | ---------------- | --------------------------------- | -| mid | num | 用户mid | | -| nickname | str | 用户昵称 | | -| avatar | str | 用户头像url | | -| rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 | -| day | num | 包月充电天数 | | -| expire_at | num | 包月充电过期时间 | 单位为秒,若从未给UP主包月充电为0 | +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ---------------- | ------------------------------- | +| mid | num | 用户mid | | +| nickname | str | 用户昵称 | | +| avatar | str | 用户头像url | | +| rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 | +| day | num | 包月充电天数 | | +| expire_at | num | 包月充电过期时间 | 时间戳,若从未给UP主包月充电为0 | +| remain_days | num | 未过期时:剩余天数
已过期且之前给UP主包月充电过:自过期以来的天数 | | **示例:** @@ -354,7 +534,8 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \ "avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png", "rank": 1, "day": 31, - "expire_at": 0 + "expire_at": 0, + "remain_days": 0 } ], "user_info": { @@ -363,7 +544,8 @@ curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \ "avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png", "rank": 1, "day": 31, - "expire_at": 1678723199 + "expire_at": 1678723199, + "remain_days": 15 }, "member_total": 1 }