新增包月充电功能相关API (#626)
* Update charge_list.md * Update charge_msg.md * Update relation.md * Update relation.md * update * Update monthly.md * Update monthly.md * update
This commit is contained in:
wuziqian211
GitHub
parent
f6760f4be3
commit
490d4c5e1f
@ -168,8 +168,9 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
|
|||||||
- [x] [实时广播（通讯协议）](docs/broadcast)
|
- [x] [实时广播（通讯协议）](docs/broadcast)
|
||||||
- [x] [视频内广播](docs/broadcast/video_room.md)
|
- [x] [视频内广播](docs/broadcast/video_room.md)
|
||||||
- [ ] [充电](docs/electric)
|
- [ ] [充电](docs/electric)
|
||||||
- [x] [B币方式](docs/electric/Bcoin.md)
|
- [ ] [包月充电操作](docs/electric/monthly.md)
|
||||||
- [x] [微信 & 支付宝方式](docs/electric/WeChat&Alipay.md)
|
- [x] [自定义充电（B币方式）](docs/electric/Bcoin.md)
|
||||||
|
- [x] [自定义充电（微信 & 支付宝方式）](docs/electric/WeChat&Alipay.md)
|
||||||
- [x] [充电留言](docs/electric/charge_msg.md)
|
- [x] [充电留言](docs/electric/charge_msg.md)
|
||||||
- [x] [充电列表](docs/electric/charge_list.md)
|
- [x] [充电列表](docs/electric/charge_list.md)
|
||||||
- [ ] [动态](docs/dynamic)
|
- [ ] [动态](docs/dynamic)
|
||||||
|
|||||||
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
## 获取空间充电公示列表
|
## 获取空间充电公示列表
|
||||||
|
|
||||||
> https://elec.bilibili.com/api/query.rank.do
|
> https://api.bilibili.com/x/ugcpay-rank/elec/month/up
|
||||||
|
|
||||||
*请求方式:GET*
|
*请求方式:GET*
|
||||||
|
|
||||||
@ -10,27 +10,28 @@
|
|||||||
|
|
||||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||||
| ------ | ---- | ----------- | ------ | ---- |
|
| ------ | ---- | ----------- | ------ | ---- |
|
||||||
| mid | num | 目标用户mid | 必要 | |
|
| up_mid | num | 目标用户mid | 必要 | |
|
||||||
|
|
||||||
**json回复：**
|
**json回复：**
|
||||||
|
|
||||||
根对象：
|
根对象：
|
||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ---- | ---- | -------- | ----------------------------- |
|
| ------- | ---- | -------- | ---------------------------- |
|
||||||
| code | num | 返回值 | 0：成功 <br />500011：mid错误 |
|
| code | num | 返回值 | 0：成功 <br />-400：请求错误 |
|
||||||
| msg | str | 错误信息 | 正确时无此项 |
|
| message | str | 错误信息 | |
|
||||||
| data | obj | 数据本体 | |
|
| ttl | num | 0 | |
|
||||||
|
| data | obj | 数据本体 | |
|
||||||
|
|
||||||
`data`对象：
|
`data`对象：
|
||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ----------- | ------ | ---------------- | ------------ |
|
| ----------- | ----- | ---------------- | ------------ |
|
||||||
| display_num | num | 0 | 作用尚不明确 |
|
| count | num | 本月充电人数 | |
|
||||||
| count | num | 本月充电人数 | |
|
|
||||||
| total_count | num | 总计充电人数 | |
|
|
||||||
| list | array | 本月充电用户列表 | |
|
| list | array | 本月充电用户列表 | |
|
||||||
| user | null | | 作用尚不明确 |
|
| total_count | num | 总计充电次数 | |
|
||||||
|
| total | num | 总计充电次数 | 同上 |
|
||||||
|
| special_day | num | 0 | 作用尚不明确 |
|
||||||
|
|
||||||
`data`中的`list`数组：
|
`data`中的`list`数组：
|
||||||
|
|
||||||
@ -43,32 +44,32 @@
|
|||||||
|
|
||||||
`data`中的`list`数组中的对象：
|
`data`中的`list`数组中的对象：
|
||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ----------- | ---- | ---------------- | ---------------- |
|
| ---------- | ---- | ---------------- | ---------------- |
|
||||||
| mid | num | 充电对象mid | |
|
| uname | str | 充电用户昵称 | |
|
||||||
| pay_mid | num | 充电用户mid | |
|
| avatar | str | 充电用户头像url | |
|
||||||
| rank | num | 充电用户排名 | 取决于充电的多少 |
|
| mid | num | 充电对象mid | |
|
||||||
| uname | str | 充电用户昵称 | |
|
| pay_mid | num | 充电用户mid | |
|
||||||
| avatar | str | 充电用户头像url | |
|
| rank | num | 充电用户排名 | 取决于充电的多少 |
|
||||||
| message | str | 充电留言 | 无为空 |
|
| trend_type | num | 0 | 作用尚不明确 |
|
||||||
| msg_deleted | num | 0 | 作用尚不明确 |
|
| vip_info | obj | 充电用户会员信息 | |
|
||||||
| vip_info | obj | 充电用户会员信息 | |
|
| message | str | 充电留言 | 无为空 |
|
||||||
| trend_type | num | 0 | 作用尚不明确 |
|
| msg_hidden | num | 0 | 作用尚不明确 |
|
||||||
|
|
||||||
`data`中的`list`数组中的对象中的`vip_info`对象：
|
`list`数组中的对象中的`vip_info`对象：
|
||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ---------- | ---- | ---------- | ----------------------------------- |
|
| ---------- | ---- | -------------------- | ----------------------------------------- |
|
||||||
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员 |
|
| vipDueMsec | num | 大会员过期时间（？） | 恒为0 |
|
||||||
| vipDueMsec | num | 0 | 作用尚不明确 |
|
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
|
||||||
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
|
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员及以上 |
|
||||||
|
|
||||||
**示例：**
|
**示例：**
|
||||||
|
|
||||||
查询用户`mid=53456`的充电公示列表
|
查询用户`mid=53456`的充电公示列表
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
curl -G 'https://elec.bilibili.com/api/query.rank.do' \
|
curl -G 'https://api.bilibili.com/x/ugcpay-rank/elec/month/up?up_mid=53456' \
|
||||||
--data-urlencode 'mid=53456'
|
--data-urlencode 'mid=53456'
|
||||||
```
|
```
|
||||||
|
|
||||||
@ -78,59 +79,60 @@ curl -G 'https://elec.bilibili.com/api/query.rank.do' \
|
|||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"code": 0,
|
"code": 0,
|
||||||
|
"message": "",
|
||||||
|
"ttl": 0,
|
||||||
"data": {
|
"data": {
|
||||||
"display_num": 0,
|
"count": 397,
|
||||||
"count": 226,
|
|
||||||
"total_count": 11528,
|
|
||||||
"list": [
|
"list": [
|
||||||
{
|
{
|
||||||
|
"uname": "Mars韩笑",
|
||||||
|
"avatar": "https://i1.hdslb.com/bfs/face/a46599fa41cac672eda677e334f0be93cca02f1f.jpg",
|
||||||
"mid": 53456,
|
"mid": 53456,
|
||||||
"pay_mid": 346545025,
|
"pay_mid": 5683462,
|
||||||
"rank": 1,
|
"rank": 1,
|
||||||
"uname": "还有什么名字没人用",
|
"trend_type": 0,
|
||||||
"avatar": "http://i1.hdslb.com/bfs/face/76d4b1ecd13e992a6c7303d77bf716dd922ab234.jpg",
|
|
||||||
"message": "早日康复，五月快乐",
|
|
||||||
"msg_deleted": 0,
|
|
||||||
"vip_info": {
|
"vip_info": {
|
||||||
"vipType": 2,
|
|
||||||
"vipDueMsec": 0,
|
"vipDueMsec": 0,
|
||||||
"vipStatus": 1
|
"vipStatus": 1,
|
||||||
|
"vipType": 2
|
||||||
},
|
},
|
||||||
"trend_type": 0
|
"message": "你真棒，你是奇迹！（Warma真的是太棒了！",
|
||||||
|
"message_hidden": 0
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
|
"uname": "愚星-",
|
||||||
|
"avatar": "https://i1.hdslb.com/bfs/face/7e4a8b150567a20a1b075aa3894dd3674a1e6ebe.jpg",
|
||||||
"mid": 53456,
|
"mid": 53456,
|
||||||
"pay_mid": 8826056,
|
"pay_mid": 382630072,
|
||||||
"rank": 2,
|
"rank": 2,
|
||||||
"uname": "煋痕",
|
"trend_type": 0,
|
||||||
"avatar": "http://i2.hdslb.com/bfs/face/35b7c752d0eb1bb7a924804f240b9bfd9199625f.jpg",
|
|
||||||
"message": "",
|
|
||||||
"msg_deleted": 0,
|
|
||||||
"vip_info": {
|
"vip_info": {
|
||||||
"vipType": 2,
|
|
||||||
"vipDueMsec": 0,
|
"vipDueMsec": 0,
|
||||||
"vipStatus": 1
|
"vipStatus": 1,
|
||||||
|
"vipType": 1
|
||||||
},
|
},
|
||||||
"trend_type": 0
|
"message": "感谢您给我带来的快乐！我的人生遇见你是我的荣幸！！",
|
||||||
|
"message_hidden": 0
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
|
"uname": "なか酱",
|
||||||
|
"avatar": "https://i0.hdslb.com/bfs/face/d4b74091d7f1c336399625dc062ddc93d676bcdc.jpg",
|
||||||
"mid": 53456,
|
"mid": 53456,
|
||||||
"pay_mid": 356668487,
|
"pay_mid": 446080731,
|
||||||
"rank": 3,
|
"rank": 3,
|
||||||
"uname": "舞象祥",
|
"trend_type": 0,
|
||||||
"avatar": "http://i1.hdslb.com/bfs/face/574f6203ef5bd0d56b95ded6a2736676d9cc5307.jpg",
|
|
||||||
"message": "warma hayo",
|
|
||||||
"msg_deleted": 0,
|
|
||||||
"vip_info": {
|
"vip_info": {
|
||||||
"vipType": 1,
|
|
||||||
"vipDueMsec": 0,
|
"vipDueMsec": 0,
|
||||||
"vipStatus": 1
|
"vipStatus": 1,
|
||||||
|
"vipType": 2
|
||||||
},
|
},
|
||||||
"trend_type": 0
|
"message": "",
|
||||||
},
|
"message_hidden": 0
|
||||||
…………
|
}
|
||||||
],
|
],
|
||||||
"user": null
|
"total_count": 27291,
|
||||||
|
"total": 27291,
|
||||||
|
"special_day": 0
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
@ -434,8 +436,8 @@ curl -L -X GET 'https://pay.bilibili.com/bk/brokerage/listForCustomerRechargeRec
|
|||||||
|
|
||||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||||
| -------- | ---- | -------- | ------ | -------------------------------- |
|
| -------- | ---- | -------- | ------ | -------------------------------- |
|
||||||
| pn | num | 页数 | 必要 | |
|
| pn | num | 页数 | 非必要 | |
|
||||||
| ps | num | 分页大小 | 必要 | 取值范围[1,20] |
|
| ps | num | 分页大小 | 非必要 | 取值范围[1,20] |
|
||||||
|
|
||||||
**json回复：**
|
**json回复：**
|
||||||
|
|
||||||
|
|||||||
@ -164,7 +164,7 @@ 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?id=6662619
|
> https://member.bilibili.com/x/web/elec/remark/detail
|
||||||
|
|
||||||
认证方式：Cookie（SESSDATA）
|
认证方式：Cookie（SESSDATA）
|
||||||
|
|
||||||
@ -293,4 +293,4 @@ curl -L -X POST 'https://member.bilibili.com/x/web/elec/remark/reply' \
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|||||||
373
docs/electric/monthly.md
Normal file
373
docs/electric/monthly.md
Normal file
@ -0,0 +1,373 @@
|
|||||||
|
# 包月充电
|
||||||
|
|
||||||
|
<img src="../../assets/img/battery-100.png" width="100" height="100"/>
|
||||||
|
|
||||||
|
## UP主包月充电详情
|
||||||
|
|
||||||
|
> https://api.bilibili.com/x/upower/item/detail
|
||||||
|
|
||||||
|
*请求方式：GET*
|
||||||
|
|
||||||
|
**url参数：**
|
||||||
|
|
||||||
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||||
|
| ------ | ---- | ----------- | ------ | ---- |
|
||||||
|
| up_mid | num | 目标用户mid | 必要 | |
|
||||||
|
|
||||||
|
**json回复：**
|
||||||
|
|
||||||
|
根对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ------- | ---- | -------- | --------------------------------------------------------------- |
|
||||||
|
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />203101：UP主未开通包月充电功能 |
|
||||||
|
| message | str | 错误信息 | 默认为0 |
|
||||||
|
| ttl | num | 1 | |
|
||||||
|
| data | obj | 信息本体 | |
|
||||||
|
|
||||||
|
`data`对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ----------- | ---- | ---------- | ---- |
|
||||||
|
| upower_rank | obj | 充电详情 | |
|
||||||
|
| item | obj | 充电欢迎语 | |
|
||||||
|
| user_card | obj | UP主信息 | |
|
||||||
|
|
||||||
|
`data`中的`upower_rank`对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ---------- | ----- | ---------------- | ------------ |
|
||||||
|
| total | num | 充电用户总数 | |
|
||||||
|
| total_desc | str | 充电总数文字说明 | 示例：“1+” |
|
||||||
|
| list | array | 充电用户列表 | 最多展示30个 |
|
||||||
|
|
||||||
|
`upower_rank`中的`list`数组：
|
||||||
|
|
||||||
|
| 项 | 类型 | 内容 | 备注 |
|
||||||
|
| ---- | ---- | --------- | ---------------- |
|
||||||
|
| 0 | obj | 用户1 | |
|
||||||
|
| n | obj | 用户(n+1) | 按照充电时间排序 |
|
||||||
|
| …… | obj | …… | …… |
|
||||||
|
|
||||||
|
数组`list`中的对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| -------- | ---- | --------------- | ---- |
|
||||||
|
| rank | num | 充电用户索引 | |
|
||||||
|
| mid | num | 充电用户mid | |
|
||||||
|
| nickname | str | 充电用户昵称 | |
|
||||||
|
| avatar | str | 充电用户头像url | |
|
||||||
|
|
||||||
|
`data`中的`item`对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| --------------- | ---- | ---------------- | ---- |
|
||||||
|
| intro_video_aid | str | 充电介绍视频AV号 | |
|
||||||
|
| welcomes | str | 充电介绍语 | |
|
||||||
|
|
||||||
|
`data`中的`user_card`对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| -------- | ---- | ----------- | ---- |
|
||||||
|
| avatar | str | UP主头像url | |
|
||||||
|
| nickname | str | UP主昵称 | |
|
||||||
|
|
||||||
|
**示例：**
|
||||||
|
|
||||||
|
获取`mid=293793435`的包月充电详情
|
||||||
|
|
||||||
|
|
||||||
|
```shell
|
||||||
|
curl 'https://api.bilibili.com/x/upower/item/detail' \
|
||||||
|
--data-urlencode 'up_mid=293793435' \
|
||||||
|
-b 'SESSDATA=xxx'
|
||||||
|
```
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>查看响应示例：</summary>
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 0,
|
||||||
|
"message": "0",
|
||||||
|
"ttl": 1,
|
||||||
|
"data": {
|
||||||
|
"upower_rank": {
|
||||||
|
"total": 1,
|
||||||
|
"total_desc": "1+",
|
||||||
|
"list": [
|
||||||
|
{
|
||||||
|
"rank": 1,
|
||||||
|
"mid": 425503913,
|
||||||
|
"nickname": "wuziqian211",
|
||||||
|
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"item": {
|
||||||
|
"intro_video_aid": "",
|
||||||
|
"welcomes": "哈喽b站的小伙伴们，我的充电计划升级啦！ 感兴趣就多多支持我吧~(゜-゜)つロ"
|
||||||
|
},
|
||||||
|
"user_card": {
|
||||||
|
"avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
|
||||||
|
"nickname": "社会易姐QwQ"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
## 与UP主的包月充电关系
|
||||||
|
|
||||||
|
> https://api.bilibili.com/x/upower/charge/follow/info
|
||||||
|
|
||||||
|
*请求方式：GET*
|
||||||
|
|
||||||
|
认证方式：Cookie(SESSDATA)或APP
|
||||||
|
|
||||||
|
**url参数：**
|
||||||
|
|
||||||
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||||
|
| ------ | ---- | ----------- | ------ | ---- |
|
||||||
|
| up_mid | num | 目标用户mid | 必要 | |
|
||||||
|
|
||||||
|
**json回复：**
|
||||||
|
|
||||||
|
根对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ------- | ---- | -------- | ------------------------------------------------- |
|
||||||
|
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
|
||||||
|
| message | str | 错误信息 | 默认为0 |
|
||||||
|
| ttl | num | 1 | |
|
||||||
|
| data | obj | 信息本体 | |
|
||||||
|
|
||||||
|
`data`对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ---------------- | ---- | ------------------------ | ------------------------------------------- |
|
||||||
|
| days | num | 已保持多少天包月充电状态 | |
|
||||||
|
| up_card | obj | UP主信息 | |
|
||||||
|
| user_card | obj | 自己的信息 | |
|
||||||
|
| remain_days | num | 剩余天数 | 未处于包月充电状态为-1 |
|
||||||
|
| remain_less_1day | num | 剩余的天数小于1天 | 0：否<br />1：是<br />未处于包月充电状态为0 |
|
||||||
|
| upower_rank | obj | 充电详情 | |
|
||||||
|
| upower_icon | str | 充电图标url | |
|
||||||
|
|
||||||
|
`data`中的`up_card`对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| -------------- | ---- | ------------ | ---- |
|
||||||
|
| nickname | str | UP主昵称 | |
|
||||||
|
| official_title | str | UP主认证信息 | |
|
||||||
|
| avatar | str | UP主头像url | |
|
||||||
|
|
||||||
|
`data`中的`user_card`对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| -------- | ---- | ----------- | ---- |
|
||||||
|
| avatar | str | 用户头像url | |
|
||||||
|
| nickname | str | 用户昵称 | |
|
||||||
|
|
||||||
|
`data`中的`upower_rank`对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ---------- | ----- | ---------------- | ----------- |
|
||||||
|
| total | num | 充电用户总数 | |
|
||||||
|
| total_desc | str | 充电总数文字说明 | 示例：“1+” |
|
||||||
|
| list | array | 充电用户列表 | 最多展示6个 |
|
||||||
|
|
||||||
|
`upower_rank`中的`list`数组：
|
||||||
|
|
||||||
|
| 项 | 类型 | 内容 | 备注 |
|
||||||
|
| ---- | ---- | --------- | ---------------- |
|
||||||
|
| 0 | obj | 用户1 | |
|
||||||
|
| n | obj | 用户(n+1) | 按照充电时间排序 |
|
||||||
|
| …… | obj | …… | …… |
|
||||||
|
|
||||||
|
数组`list`中的对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| -------- | ---- | --------------- | ---- |
|
||||||
|
| rank | num | 充电用户索引 | |
|
||||||
|
| mid | num | 充电用户mid | |
|
||||||
|
| nickname | str | 充电用户昵称 | |
|
||||||
|
| avatar | str | 充电用户头像url | |
|
||||||
|
|
||||||
|
**示例：**
|
||||||
|
|
||||||
|
获取与`mid=293793435`的包月充电关系
|
||||||
|
|
||||||
|
|
||||||
|
```shell
|
||||||
|
curl 'https://api.bilibili.com/x/upower/charge/follow/info' \
|
||||||
|
--data-urlencode 'up_mid=293793435' \
|
||||||
|
-b 'SESSDATA=xxx'
|
||||||
|
```
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>查看响应示例：</summary>
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 0,
|
||||||
|
"message": "0",
|
||||||
|
"ttl": 1,
|
||||||
|
"data": {
|
||||||
|
"days": 17,
|
||||||
|
"up_card": {
|
||||||
|
"nickname": "社会易姐QwQ",
|
||||||
|
"official_title": "",
|
||||||
|
"avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg"
|
||||||
|
},
|
||||||
|
"user_card": {
|
||||||
|
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
|
||||||
|
"nickname": "wuziqian211"
|
||||||
|
},
|
||||||
|
"remain_days": 15,
|
||||||
|
"remain_less_1day": 0,
|
||||||
|
"upower_rank": {
|
||||||
|
"total": 1,
|
||||||
|
"total_desc": "1+",
|
||||||
|
"list": [
|
||||||
|
{
|
||||||
|
"rank": 1,
|
||||||
|
"mid": 425503913,
|
||||||
|
"nickname": "wuziqian211",
|
||||||
|
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"upower_icon": "https://i0.hdslb.com/bfs/garb/item/33e2e72d9a0c855f036b4cb55448f44af67a0635.png"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
## 包月充电用户排名
|
||||||
|
|
||||||
|
> https://api.bilibili.com/x/upower/up/member/rank/v2
|
||||||
|
|
||||||
|
*请求方式：GET*
|
||||||
|
|
||||||
|
**url参数：**
|
||||||
|
|
||||||
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||||
|
| ------ | ---- | ----------- | ------ | -------- |
|
||||||
|
| up_mid | num | 目标用户mid | 必要 | |
|
||||||
|
| ps | num | 每页项数 | 非必要 | 默认为20 |
|
||||||
|
| pn | num | 页码 | 非必要 | 默认为1 |
|
||||||
|
|
||||||
|
**json回复：**
|
||||||
|
|
||||||
|
根对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ------- | ---- | -------- | --------------------------- |
|
||||||
|
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
|
||||||
|
| message | str | 错误信息 | 默认为0 |
|
||||||
|
| ttl | num | 1 | |
|
||||||
|
| data | obj | 信息本体 | |
|
||||||
|
|
||||||
|
`data`对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ------------ | ----- | ------------ | ---- |
|
||||||
|
| up_info | obj | UP主信息 | |
|
||||||
|
| rank_info | array | 充电用户排名 | |
|
||||||
|
| user_info | obj | 自己的信息 | |
|
||||||
|
| member_total | num | 充电用户总数 | |
|
||||||
|
|
||||||
|
`data`中的`up_info`对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| -------- | ---- | ------------ | ---------------------------------------- |
|
||||||
|
| mid | num | UP主mid | |
|
||||||
|
| nickname | str | UP主昵称 | |
|
||||||
|
| avatar | str | UP主头像url | |
|
||||||
|
| type | num | UP主认证类型 | -1：无<br />0：UP主认证<br />1：机构认证 |
|
||||||
|
| title | str | UP主认证信息 | |
|
||||||
|
|
||||||
|
`data`中的`rank_info`数组：
|
||||||
|
|
||||||
|
| 项 | 类型 | 内容 | 备注 |
|
||||||
|
| ---- | ---- | --------- | ---------------- |
|
||||||
|
| 0 | obj | 用户1 | |
|
||||||
|
| n | obj | 用户(n+1) | 按照充电排名排列 |
|
||||||
|
| …… | obj | …… | …… |
|
||||||
|
|
||||||
|
数组`rank_info`中的对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| --------- | ---- | ---------------- | ----- |
|
||||||
|
| mid | num | 充电用户mid | |
|
||||||
|
| nickname | str | 充电用户昵称 | |
|
||||||
|
| avatar | str | 充电用户头像url | |
|
||||||
|
| rank | num | 充电用户排名 | |
|
||||||
|
| day | num | 包月充电天数 | |
|
||||||
|
| expire_at | num | 包月充电过期时间 | 恒为0 |
|
||||||
|
|
||||||
|
`data`中的`user_info`对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| --------- | ---- | ---------------- | --------------------------------- |
|
||||||
|
| mid | num | 用户mid | |
|
||||||
|
| nickname | str | 用户昵称 | |
|
||||||
|
| avatar | str | 用户头像url | |
|
||||||
|
| rank | num | 包月充电排名 | 不在包月充电用户列表里为-1 |
|
||||||
|
| day | num | 包月充电天数 | |
|
||||||
|
| expire_at | num | 包月充电过期时间 | 单位为秒，若从未给UP主包月充电为0 |
|
||||||
|
|
||||||
|
**示例：**
|
||||||
|
|
||||||
|
获取给`mid=293793435`包月充电的用户排名
|
||||||
|
|
||||||
|
|
||||||
|
```shell
|
||||||
|
curl 'https://api.bilibili.com/x/upower/up/member/rank/v2' \
|
||||||
|
--data-urlencode 'up_mid=293793435' \
|
||||||
|
-b 'SESSDATA=xxx'
|
||||||
|
```
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>查看响应示例：</summary>
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 0,
|
||||||
|
"message": "0",
|
||||||
|
"ttl": 1,
|
||||||
|
"data": {
|
||||||
|
"up_info": {
|
||||||
|
"mid": 293793435,
|
||||||
|
"nickname": "社会易姐QwQ",
|
||||||
|
"avatar": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
|
||||||
|
"type": -1,
|
||||||
|
"title": ""
|
||||||
|
},
|
||||||
|
"rank_info": [
|
||||||
|
{
|
||||||
|
"mid": 425503913,
|
||||||
|
"nickname": "wuziqian211",
|
||||||
|
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
|
||||||
|
"rank": 1,
|
||||||
|
"day": 31,
|
||||||
|
"expire_at": 0
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"user_info": {
|
||||||
|
"mid": 425503913,
|
||||||
|
"nickname": "wuziqian211",
|
||||||
|
"avatar": "https://i2.hdslb.com/bfs/face/390f4b18b8b15c1f2ecdb6ee44e572aa18b9b2d0.png",
|
||||||
|
"rank": 1,
|
||||||
|
"day": 31,
|
||||||
|
"expire_at": 1678723199
|
||||||
|
},
|
||||||
|
"member_total": 1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
@ -202,7 +202,7 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \
|
|||||||
| ttl | num | 1 | |
|
| ttl | num | 1 | |
|
||||||
| data | obj | 信息本体 | |
|
| data | obj | 信息本体 | |
|
||||||
|
|
||||||
data 对象：
|
`data`对象：
|
||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ---------- | ----- | -------- | ------------ |
|
| ---------- | ----- | -------- | ------------ |
|
||||||
@ -356,32 +356,28 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
|
|||||||
|
|
||||||
*请求方式：GET*
|
*请求方式：GET*
|
||||||
|
|
||||||
认证方式：Cookie(SESSDATA)或APP
|
仅可查看前5页，可以获取已设置可见性隐私的关注列表
|
||||||
|
|
||||||
登录可看自己全部，其他用户仅可查看前5页，可以获取已设置可见性隐私的关注列表
|
|
||||||
|
|
||||||
**url参数：**
|
**url参数：**
|
||||||
|
|
||||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||||
| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
|
| ---------- | ---- | ------------ | ------ | -------------------------- |
|
||||||
| access_key | str | APP登录Token | APP方式必要 | |
|
| vmid | num | 目标用户mid | 必要 | |
|
||||||
| vmid | num | 目标用户mid | 必要 | |
|
| ps | num | 每页项数 | 非必要 | 默认为50 |
|
||||||
| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空<br />按照最常访问排列：attention |
|
| pn | num | 页码 | 非必要 | 默认为1<br />仅可查看前5页 |
|
||||||
| ps | num | 每页项数 | 非必要 | 默认为50 |
|
|
||||||
| pn | num | 页码 | 非必要 | 默认为1<br />其他用户仅可查看前5页 |
|
|
||||||
|
|
||||||
**json回复：**
|
**json回复：**
|
||||||
|
|
||||||
根对象：
|
根对象：
|
||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ------- | ---- | -------- | ------------------------------------------------------------ |
|
| ------- | ---- | -------- | --------------------------------------------------- |
|
||||||
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />22007：访问超过5页 |
|
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />22007：访问超过5页 |
|
||||||
| message | str | 错误信息 | 默认为0 |
|
| message | str | 错误信息 | 默认为0 |
|
||||||
| ttl | num | 1 | |
|
| ttl | num | 1 | |
|
||||||
| data | obj | 信息本体 | |
|
| data | obj | 信息本体 | |
|
||||||
|
|
||||||
data 对象：
|
`data`对象：
|
||||||
|
|
||||||
| 字段 | 类型 | 内容 | 备注 |
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
| ---------- | ----- | -------- | ------------ |
|
| ---------- | ----- | -------- | ------------ |
|
||||||
@ -453,10 +449,8 @@ data 对象：
|
|||||||
```shell
|
```shell
|
||||||
curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
|
curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
|
||||||
--data-urlencode 'vmid=293793435' \
|
--data-urlencode 'vmid=293793435' \
|
||||||
--data-urlencode 'order_type=' \
|
|
||||||
--data-urlencode 'ps=2' \
|
--data-urlencode 'ps=2' \
|
||||||
--data-urlencode 'pn=1' \
|
--data-urlencode 'pn=1' \
|
||||||
-b 'SESSDATA=xxx'
|
|
||||||
```
|
```
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
@ -527,6 +521,97 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
|
|||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
|
## 查询用户关注明细3
|
||||||
|
|
||||||
|
<img src="../../assets/img/relation.svg" width="100" height="100" />
|
||||||
|
|
||||||
|
> https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list
|
||||||
|
|
||||||
|
*请求方式：GET*
|
||||||
|
|
||||||
|
可获取用户所有关注列表，对于设置了可见性隐私的用户会返回空列表
|
||||||
|
|
||||||
|
**url参数：**
|
||||||
|
|
||||||
|
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||||
|
| ------ | ---- | ------------ | ----------- | -------- |
|
||||||
|
| vmid | num | 目标用户mid | 必要 | |
|
||||||
|
| ps | num | 每页项数 | 非必要 | 默认为20 |
|
||||||
|
| pn | num | 页码 | 非必要 | 默认为1 |
|
||||||
|
|
||||||
|
**json回复：**
|
||||||
|
|
||||||
|
根对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ---------- | ---- | ---------- | --------------------------- |
|
||||||
|
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
|
||||||
|
| message | str | 错误信息 | 成功时无此项 |
|
||||||
|
| data | obj | 信息本体 | 失败时无此项 |
|
||||||
|
| ts | num | 当前时间戳 | 单位为毫秒 |
|
||||||
|
| request_id | str | 请求id | |
|
||||||
|
|
||||||
|
`data`对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| ---------- | ----- | -------- | ------------ |
|
||||||
|
| list | array | 明细列表 | |
|
||||||
|
|
||||||
|
`data`中的`list`数组：
|
||||||
|
|
||||||
|
| 项 | 类型 | 内容 | 备注 |
|
||||||
|
| ---- | ---- | --------- | ---------------- |
|
||||||
|
| 0 | obj | 关注1 | |
|
||||||
|
| n | obj | 关注(n+1) | 按照关注顺序排列 |
|
||||||
|
| …… | obj | …… | …… |
|
||||||
|
|
||||||
|
数组`list`中的对象：
|
||||||
|
|
||||||
|
| 字段 | 类型 | 内容 | 备注 |
|
||||||
|
| --------------- | ---- | ----------- | --------------------------------------- |
|
||||||
|
| mid | str | 用户mid | |
|
||||||
|
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
|
||||||
|
| uname | str | 用户昵称 | |
|
||||||
|
| face | str | 用户头像url | |
|
||||||
|
|
||||||
|
**示例：**
|
||||||
|
|
||||||
|
获取用户`mid=293793435`的关注明细
|
||||||
|
|
||||||
|
```shell
|
||||||
|
curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list' \
|
||||||
|
--data-urlencode 'vmid=293793435' \
|
||||||
|
--data-urlencode 'ps=2' \
|
||||||
|
--data-urlencode 'pn=1' \
|
||||||
|
-b 'SESSDATA=xxx'
|
||||||
|
```
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>查看响应示例：</summary>
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"code": 0,
|
||||||
|
"data": {
|
||||||
|
"list": [{
|
||||||
|
"mid": "14082",
|
||||||
|
"attribute": 2,
|
||||||
|
"uname": "山新",
|
||||||
|
"face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg"
|
||||||
|
}, {
|
||||||
|
"mid": "420831218",
|
||||||
|
"attribute": 2,
|
||||||
|
"uname": "支付宝Alipay",
|
||||||
|
"face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg"
|
||||||
|
}]
|
||||||
|
},
|
||||||
|
"ts": 1677410818395,
|
||||||
|
"request_id": "d9d541b9f2d24e21821e2d6d2d16c17d"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
## 搜索关注明细
|
## 搜索关注明细
|
||||||
|
|
||||||
<img src="../../assets/img/relation.svg" width="100" height="100" />
|
<img src="../../assets/img/relation.svg" width="100" height="100" />
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user