From c7400fffdf05734a889fc782bbddec95937b7698 Mon Sep 17 00:00:00 2001
From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com>
Date: Fri, 10 Mar 2023 00:17:02 +0800
Subject: [PATCH] Update monthly.md
---
docs/electric/monthly.md | 220 +++++++++++++++++++++++++++++++++++----
1 file changed, 201 insertions(+), 19 deletions(-)
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
}