Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

update

Browse Source
This commit is contained in:
晨叶梦春
2025-02-25 23:51:36 +08:00
parent 4dea795ed6
commit 6c1f03e753
8 changed files with 382 additions and 360 deletions
Download Patch File Download Diff File Expand all files Collapse all files

134
docs/electric/Bcoin.md
View File

@@ -31,7 +31,7 @@
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功（并不代表充电成功） <br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误 |
| code | num | 返回值 | 0：成功（并不代表充电成功） <br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-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 币余额不足"
}
}
```

54
docs/electric/WeChat&Alipay.md
View File

@@ -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：是<br />false：否<br />在B币不足时剩余的部分利用支付平台支付 |
| up_mid | num | 充电对象用户mid | 必要 | |
| otype | str | 充电来源 | 必要 | up：空间充电<br />archive：视频充电 |
| oid | num | 充电来源代码 | 必要 | 空间充电：充电对象用户mid<br />视频充电：稿件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
}
}
```
</details>
当申请到的支付二维码已扫描但未确认时，`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
}
}
```
</details>
成功支付后，`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
}
}
```

192
docs/electric/charge_list.md
View File

@@ -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：无<br />1：有 |
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员及以上 |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | -------------- | ----- |
| vipDueMsec | num | 大会员过期时间 | 恒为0 |
| vipStatus | num | 大会员状态 | 包月充电时恒为0<br />自定义充电：<br />0：无<br />1：有 |
| vipType | num | 大会员类型 | 包月充电时恒为0<br />自定义充电：<br />0：无<br />1：月大会员<br />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：不展示<br />true：展示 |
| state | num | 0 | |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------------------ | ---------------- |
| show | bool | 是否展示视频充电鸣谢名单 | |
| state | num | 充电功能开启状态 | -1：未开通充电功能<br />1：已开通自定义充电<br />2：已开通包月、自定义充电<br />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：无<br />1：月会员<br />2：年会员 |
| vipDueMsec | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | -------------- | ----- |
| vipType | num | 大会员类型 | 包月充电时恒为0<br />自定义充电：<br />0：无<br />1：月大会员<br />2：年度及以上大会员 |
| vipDueMsec | num | 大会员过期时间 | 恒为0 |
| vipStatus | num | 大会员状态 | 包月充电时恒为0<br />自定义充电：<br />0：无<br />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：成功<br />800501007：user not login<br />800501008：内部错误<br /> 800501011：请求参数有误 |
| code | num | 返回值 | 0：成功<br />800501007：user not login<br />800501008：内部错误<br />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

194
docs/electric/charge_msg.md
View File

@@ -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'
```
<details>
@@ -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：成功<br />-101：账号未登录|
| msg | str | 0 | |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0：成功<br />-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：未回复<br />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：未回复<br />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'
```
<details>
@@ -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：成功<br />-101：账号未登录<br />-400：请求错误|
| message | str | 0 | |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-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：未回复<br />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：未回复<br />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'
```
<details>
@@ -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：成功<br />-101：账号未登录<br />-111：csrf 校验失败<br />-400：请求错误20004：充电服务异常<br /> |
| message | str | 错误信息 | |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf 校验失败<br />-400：请求错误<br />20004：充电服务异常 |
| message | str | 错误信息 | |
| ttl | num | 1 | |
| data | num | 数据本体 | 1：成功<br />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￣)'
```
<details>

29
docs/electric/monthly.md
View File

@@ -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：普通包月充电<br />20：高档充电 |
| icon | str | 充电图标 | |
| name | str | `包月充电` | |
| expire_time | num | 充电过期时间 | 时间戳 |
| expire_time | num | 充电过期时间 | 秒级时间戳 |
| renew | 开启自动续费时：obj<br />关闭自动续费时：null | 充电自动续费详情 | |
数组`item`中的对象中的`renew`对象：
@@ -81,8 +81,8 @@
| ruid | num | UP主的mid | |
| goods_id | num | 充电类型 | 172：一个月<br />173：连续包月<br />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：微信支付<br />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：无<br />0：UP主认证<br />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 | 未过期时：剩余天数<br />已过期且之前给UP主包月充电过：自过期以来的天数 | |
**示例：**
获取给`mid=293793435`包月充电的用户排名
```shell
curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
--data-urlencode 'up_mid=293793435' \