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
Show Stats 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 币余额不足"
}
}
```

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

@ -24,8 +24,8 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| bp_num | num | 充电B币数量 | 必要 | 必须在2-9999之间 |
| up_mid | num | 充电对象用户mid | 必要 | |
| 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
}
}
```

170
docs/electric/charge_list.md
View File

@ -42,7 +42,6 @@
| 0 | obj | 充电用户1 | |
| n | obj | 充电用户(n+1) | 按照充电排名排列 |
| …… | obj | …… | …… |
| 29 | obj | 充电用户30 | 最后一项 |
`data`中的`list`数组中的对象：
@ -61,10 +60,10 @@
`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
}
}
@ -170,21 +146,40 @@ 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 | 作用尚不明确 |
| 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`数组中的对象：
@ -212,10 +206,10 @@ 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

106
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,59 +55,51 @@ 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 | |
| ------- | ---- | -------- | ----------------------------- |
| 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 | 记录总数 | |
| pager | obj | 分页信息 | |
`list`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ----- | ------ | ---- |
| ------------ | ---- | ---------------------- | ---- |
| aid | num | | |
| bvid | str | | |
| id | num | 留言记录id | |
| mid | num | | |
| reply_mid | num | 0| |
| mid | num | 0 | |
| reply_mid | num | 0 | |
| elec_num | num | 0 | |
| state | num | UP是否已经回复这条留言 | 0：未回复<br />1：已回复 |
| msg | str | 留言信息 | |
| aname | str | 空 | |
| uname | str |空 | |
| uname | str | 空 | |
| avator | str | 空 | |
| reply_name | str | 空 | |
| reply_avator | str | 空 | |
@ -115,11 +107,19 @@ curl 'https://api.bilibili.com/x/ugcpay/trade/elec/message' \
| 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,12 +166,14 @@ 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 | 必要 | |
**json回复：**
@ -179,21 +181,21 @@ curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/list?begin=2016-01
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误|
| message | str | 0 | |
| ------- | ---- | -------- | ------------------------------------------------- |
| 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 | |
| mid | num | 留言者mid（充电用户） | |
| reply_mid | num | UP主mid | |
| elec_num | num | 0 | |
| state | num | UP是否已经回复这条留言 | 0：未回复<br />1：已回复 |
| msg | str | 留言内容 | |
@ -209,8 +211,8 @@ curl -L -X GET 'https://member.bilibili.com/x/web/elec/remark/list?begin=2016-01
**示例：**
```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 | 回复信息 | | |
| 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 /> |
| 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>

19
docs/electric/monthly.md
View File

@ -50,12 +50,12 @@
数组`list`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------- | ----- | --------------- | ------ |
| --------- | ----- | --------------- | ---------- |
| up_uid | num | 充电UP主mid | |
| user_name | str | 充电UP主昵称 | |
| user_face | str | 充电UP主头像url | |
| item | array | 充电详情 | |
| start | num | 开始充电时间 | 时间戳 |
| 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' \

93
docs/user/info.md
View File

@ -65,8 +65,8 @@
| birthday | str | 生日 | MM-DD<br />如设置隐私为空 |
| school | obj | 学校 | |
| profession | obj | 专业资质信息 | |
| tags | null | 个人标签 | |
| series | obj | | |
| tags | 有效时：array<br />无效时：null | 个人标签 | |
| series | obj | （？） | |
| is_senior_member | num | 是否为硬核会员 | 0：否<br />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<br />无效时：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`对象：
@ -163,18 +173,19 @@
**动态头像框的`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 | |
| n_pid | num | 新版头像框id | |
`data`中的`nameplate`对象：
| 字段 | 类型 | 内容 | 备注 |
|-------------|-----|---------|-----|
| ----------- | ---- | -------------- | ---- |
| nid | num | 勋章id | |
| name | str | 勋章名称 | |
| image | str | 勋章图标 | |
@ -299,18 +310,18 @@
`data`中的`elec`对象：
| 字段 | 类型 | 内容 | 备注 |
|-----------|-----|-----|-----|
| show_info | obj | | |
| --------- | ---- | -------------- | ---- |
| show_info | obj | 显示的充电信息 | |
`elec`中的`show_info`对象：
| 字段 | 类型 | 内容 | 备注 |
|----------|------|---------|------------------|
| show | bool | 是否开通了充电 | |
| state | num | 状态 | -1：未开通<br/>1：已开通 |
| title | str | `空串` | |
| icon | str | `空串` | |
| jump_url | str | `空串` | |
| -------- | ---- | ---------------- | ---------------- |
| show | bool | 是否显示充电按钮 | |
| state | num | 充电功能开启状态 | -1：未开通充电功能<br />1：已开通自定义充电<br />2：已开通包月、自定义充电<br />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
}
}
```

12
docs/user/relation.md
View File

@ -1303,7 +1303,7 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22001：不能对自己进行此操作<br />22002：因对方隐私设置，你还不能关注<br />22003：关注失败，请将该用户移除黑名单之后再试<br />22013：账号已注销，无法完成操作<br />22014：已经关注用户，无法重复关注<br />22120：重复加入黑名单<br />40061：用户不存在 |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-102：账号被封停<br />-111：csrf校验失败<br />-400：请求错误<br />22001：不能对自己进行此操作<br />22002：因对方隐私设置，你还不能关注<br />22003：关注失败，请将该用户移除黑名单之后再试<br />22008：黑名单达到上限<br />22009：关注失败，已达关注上限<br />22013：账号已注销，无法完成操作<br />22014：已经关注用户，无法重复关注<br />22120：重复加入黑名单<br />40061：用户不存在 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
@ -2043,7 +2043,7 @@ curl 'https://api.bilibili.com/x/relation/tag/special' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22106：该分组已经存在<br />22103：分组名过长 |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22101：分组名称存在不允许的字符<br />22102：分组数量超过限制<br />22103：分组名过长<br />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：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22103：分组名过长<br />22104：该分组不存在 |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22101：分组名称存在不允许的字符<br />22103：分组名过长<br />22104：该分组不存在 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
@ -2212,7 +2212,7 @@ curl 'https://api.bilibili.com/x/relation/tag/del' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：无权限<br />22105：未关注 |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：分组不存在<br />22105：未关注 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
@ -2264,7 +2264,7 @@ curl 'https://api.bilibili.com/x/relation/tags/addUsers' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：无权限<br />22105：未关注 |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：分组不存在<br />22105：未关注 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
@ -2317,7 +2317,7 @@ curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：无权限<br />22105：未关注 |
| code | num | 返回值 | 0：成功<br />-111：csrf校验失败<br />-101：账号未登录<br />-400：请求错误<br />22104：分组不存在<br />22105：未关注 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |