From 490d4c5e1f4559e9fae0feb46e18364317a6112e Mon Sep 17 00:00:00 2001
From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com>
Date: Mon, 27 Feb 2023 14:56:38 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E5=8C=85=E6=9C=88=E5=85=85?=
=?UTF-8?q?=E7=94=B5=E5=8A=9F=E8=83=BD=E7=9B=B8=E5=85=B3API=20(#626)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
* Update charge_list.md
* Update charge_msg.md
* Update relation.md
* Update relation.md
* update
* Update monthly.md
* Update monthly.md
* update
---
README.md | 5 +-
docs/electric/charge_list.md | 128 ++++++------
docs/electric/charge_msg.md | 4 +-
docs/electric/monthly.md | 373 +++++++++++++++++++++++++++++++++++
docs/user/relation.md | 123 ++++++++++--
5 files changed, 547 insertions(+), 86 deletions(-)
create mode 100644 docs/electric/monthly.md
diff --git a/README.md b/README.md
index 63caccc..4f791f1 100644
--- a/README.md
+++ b/README.md
@@ -168,8 +168,9 @@ B站 API 采用 C/S 结构，大多数接口为 REST API 和 gRPC，少部分接
- [x] [实时广播（通讯协议）](docs/broadcast)
- [x] [视频内广播](docs/broadcast/video_room.md)
- [ ] [充电](docs/electric)
- - [x] [B币方式](docs/electric/Bcoin.md)
- - [x] [微信 & 支付宝方式](docs/electric/WeChat&Alipay.md)
+ - [ ] [包月充电操作](docs/electric/monthly.md)
+ - [x] [自定义充电（B币方式）](docs/electric/Bcoin.md)
+ - [x] [自定义充电（微信 & 支付宝方式）](docs/electric/WeChat&Alipay.md)
- [x] [充电留言](docs/electric/charge_msg.md)
- [x] [充电列表](docs/electric/charge_list.md)
- [ ] [动态](docs/dynamic)
diff --git a/docs/electric/charge_list.md b/docs/electric/charge_list.md
index c5ea951..021889a 100644
--- a/docs/electric/charge_list.md
+++ b/docs/electric/charge_list.md
@@ -2,7 +2,7 @@
## 获取空间充电公示列表
-> https://elec.bilibili.com/api/query.rank.do
+> https://api.bilibili.com/x/ugcpay-rank/elec/month/up
*请求方式:GET*
@@ -10,27 +10,28 @@
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
-| mid | num | 目标用户mid | 必要 | |
+| up_mid | num | 目标用户mid | 必要 | |
**json回复：**
根对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ---- | ---- | -------- | ----------------------------- |
-| code | num | 返回值 | 0：成功
500011：mid错误 |
-| msg | str | 错误信息 | 正确时无此项 |
-| data | obj | 数据本体 | |
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ---------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误 |
+| message | str | 错误信息 | |
+| ttl | num | 0 | |
+| data | obj | 数据本体 | |
`data`对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ----------- | ------ | ---------------- | ------------ |
-| display_num | num | 0 | 作用尚不明确 |
-| count | num | 本月充电人数 | |
-| total_count | num | 总计充电人数 | |
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ----- | ---------------- | ------------ |
+| count | num | 本月充电人数 | |
| list | array | 本月充电用户列表 | |
-| user | null | | 作用尚不明确 |
+| total_count | num | 总计充电次数 | |
+| total | num | 总计充电次数 | 同上 |
+| special_day | num | 0 | 作用尚不明确 |
`data`中的`list`数组：
@@ -43,32 +44,32 @@
`data`中的`list`数组中的对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ----------- | ---- | ---------------- | ---------------- |
-| mid | num | 充电对象mid | |
-| pay_mid | num | 充电用户mid | |
-| rank | num | 充电用户排名 | 取决于充电的多少 |
-| uname | str | 充电用户昵称 | |
-| avatar | str | 充电用户头像url | |
-| message | str | 充电留言 | 无为空 |
-| msg_deleted | num | 0 | 作用尚不明确 |
-| vip_info | obj | 充电用户会员信息 | |
-| trend_type | num | 0 | 作用尚不明确 |
+| 字段 | 类型 | 内容 | 备注 |
+| ---------- | ---- | ---------------- | ---------------- |
+| uname | str | 充电用户昵称 | |
+| avatar | str | 充电用户头像url | |
+| mid | num | 充电对象mid | |
+| pay_mid | num | 充电用户mid | |
+| rank | num | 充电用户排名 | 取决于充电的多少 |
+| trend_type | num | 0 | 作用尚不明确 |
+| vip_info | obj | 充电用户会员信息 | |
+| message | str | 充电留言 | 无为空 |
+| msg_hidden | num | 0 | 作用尚不明确 |
-`data`中的`list`数组中的对象中的`vip_info`对象：
+`list`数组中的对象中的`vip_info`对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ---------- | ---- | ---------- | ----------------------------------- |
-| vipType | num | 大会员类型 | 0：无
1：月会员
2：年会员 |
-| vipDueMsec | num | 0 | 作用尚不明确 |
-| vipStatus | num | 大会员状态 | 0：无
1：有 |
+| 字段 | 类型 | 内容 | 备注 |
+| ---------- | ---- | -------------------- | ----------------------------------------- |
+| vipDueMsec | num | 大会员过期时间（？） | 恒为0 |
+| vipStatus | num | 大会员状态 | 0：无
1：有 |
+| vipType | num | 大会员类型 | 0：无
1：月会员
2：年会员及以上 |
**示例：**
查询用户`mid=53456`的充电公示列表
```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'
```
@@ -78,59 +79,60 @@ curl -G 'https://elec.bilibili.com/api/query.rank.do' \
```json
{
"code": 0,
+ "message": "",
+ "ttl": 0,
"data": {
- "display_num": 0,
- "count": 226,
- "total_count": 11528,
+ "count": 397,
"list": [
{
+ "uname": "Mars韩笑",
+ "avatar": "https://i1.hdslb.com/bfs/face/a46599fa41cac672eda677e334f0be93cca02f1f.jpg",
"mid": 53456,
- "pay_mid": 346545025,
+ "pay_mid": 5683462,
"rank": 1,
- "uname": "还有什么名字没人用",
- "avatar": "http://i1.hdslb.com/bfs/face/76d4b1ecd13e992a6c7303d77bf716dd922ab234.jpg",
- "message": "早日康复，五月快乐",
- "msg_deleted": 0,
+ "trend_type": 0,
"vip_info": {
- "vipType": 2,
"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,
- "pay_mid": 8826056,
+ "pay_mid": 382630072,
"rank": 2,
- "uname": "煋痕",
- "avatar": "http://i2.hdslb.com/bfs/face/35b7c752d0eb1bb7a924804f240b9bfd9199625f.jpg",
- "message": "",
- "msg_deleted": 0,
+ "trend_type": 0,
"vip_info": {
- "vipType": 2,
"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,
- "pay_mid": 356668487,
+ "pay_mid": 446080731,
"rank": 3,
- "uname": "舞象祥",
- "avatar": "http://i1.hdslb.com/bfs/face/574f6203ef5bd0d56b95ded6a2736676d9cc5307.jpg",
- "message": "warma hayo",
- "msg_deleted": 0,
+ "trend_type": 0,
"vip_info": {
- "vipType": 1,
"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 | 页数 | 必要 | |
-| ps | num | 分页大小 | 必要 | 取值范围[1,20] |
+| pn | num | 页数 | 非必要 | |
+| ps | num | 分页大小 | 非必要 | 取值范围[1,20] |
**json回复：**
diff --git a/docs/electric/charge_msg.md b/docs/electric/charge_msg.md
index d12ccc3..d9b8abf 100644
--- a/docs/electric/charge_msg.md
+++ b/docs/electric/charge_msg.md
@@ -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）
@@ -293,4 +293,4 @@ curl -L -X POST 'https://member.bilibili.com/x/web/elec/remark/reply' \
}
```
-
\ No newline at end of file
+
diff --git a/docs/electric/monthly.md b/docs/electric/monthly.md
new file mode 100644
index 0000000..bf47c38
--- /dev/null
+++ b/docs/electric/monthly.md
@@ -0,0 +1,373 @@
+# 包月充电
+
+
+
+## UP主包月充电详情
+
+> https://api.bilibili.com/x/upower/item/detail
+
+*请求方式：GET*
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------- | ------ | ---- |
+| up_mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------------------------------------------- |
+| code | num | 返回值 | 0：成功
-400：请求错误
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'
+```
+
+
+查看响应示例：
+
+```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"
+ }
+ }
+}
+```
+
+
+
+## 与UP主的包月充电关系
+
+> https://api.bilibili.com/x/upower/charge/follow/info
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+**url参数：**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------ | ---- | ----------- | ------ | ---- |
+| up_mid | num | 目标用户mid | 必要 | |
+
+**json回复：**
+
+根对象：
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------- |
+| code | num | 返回值 | 0：成功
-101：账号未登录
-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：否
1：是
未处于包月充电状态为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'
+```
+
+
+查看响应示例：
+
+```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"
+ }
+}
+```
+
+
+
+## 包月充电用户排名
+
+> 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：成功
-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：无
0：UP主认证
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'
+```
+
+
+查看响应示例：
+
+```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
+ }
+}
+```
+
+
diff --git a/docs/user/relation.md b/docs/user/relation.md
index b85cc9d..375ed95 100644
--- a/docs/user/relation.md
+++ b/docs/user/relation.md
@@ -202,7 +202,7 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \
| ttl | num | 1 | |
| data | obj | 信息本体 | |
-data 对象：
+`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ------------ |
@@ -356,32 +356,28 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
*请求方式：GET*
-认证方式：Cookie(SESSDATA)或APP
-
-登录可看自己全部，其他用户仅可查看前5页，可以获取已设置可见性隐私的关注列表
+仅可查看前5页，可以获取已设置可见性隐私的关注列表
**url参数：**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
-| access_key | str | APP登录Token | APP方式必要 | |
-| vmid | num | 目标用户mid | 必要 | |
-| order_type | str | 排序方式 | 非必要 | 按照关注顺序排列：留空
按照最常访问排列：attention |
-| ps | num | 每页项数 | 非必要 | 默认为50 |
-| pn | num | 页码 | 非必要 | 默认为1
其他用户仅可查看前5页 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | ------------ | ------ | -------------------------- |
+| vmid | num | 目标用户mid | 必要 | |
+| ps | num | 每页项数 | 非必要 | 默认为50 |
+| pn | num | 页码 | 非必要 | 默认为1
仅可查看前5页 |
**json回复：**
根对象：
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ---- | -------- | ------------------------------------------------------------ |
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | --------------------------------------------------- |
| code | num | 返回值 | 0：成功
-400：请求错误
22007：访问超过5页 |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | |
-| data | obj | 信息本体 | |
+| message | str | 错误信息 | 默认为0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
-data 对象：
+`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ------------ |
@@ -453,10 +449,8 @@ data 对象：
```shell
curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
--data-urlencode 'vmid=293793435' \
---data-urlencode 'order_type=' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
--b 'SESSDATA=xxx'
```
@@ -527,6 +521,97 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
+## 查询用户关注明细3
+
+
+
+> 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：成功
-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：未关注
2：已关注
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'
+```
+
+
+查看响应示例：
+
+```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"
+}
+```
+
+
+
## 搜索关注明细