From 6c844133afa9663dc46502af993809060875adb3 Mon Sep 17 00:00:00 2001
From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com>
Date: Mon, 24 Oct 2022 20:20:17 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E5=8F=A6=E4=B8=80=E4=B8=AA?=
 =?UTF-8?q?=E8=8E=B7=E5=8F=96=E7=94=A8=E6=88=B7=E5=85=B3=E6=B3=A8=E5=88=97?=
 =?UTF-8?q?=E8=A1=A8=E7=9A=84API=20(#521)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Update info.md

* Update relation.md

* Update relation.md
---
 user/relation.md | 180 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 180 insertions(+)

diff --git a/user/relation.md b/user/relation.md
index 80645ad..291b59b 100644
--- a/user/relation.md
+++ b/user/relation.md
@@ -2,6 +2,7 @@
 
 - [查询用户粉丝明细](#查询用户粉丝明细)
 - [查询用户关注明细](#查询用户关注明细)
+- [查询用户关注明细2](#查询用户关注明细2)
 - [搜索关注明细](#搜索关注明细)
 - [查询共同关注明细](#查询共同关注明细)
 - [查询悄悄关注明细](#查询悄悄关注明细)
@@ -373,6 +374,185 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
 
 </details>
 
+## 查询用户关注明细2
+
+<img src="/imgs/relation.svg" width="100" height="100" />
+
+> https://app.biliapi.net/x/v2/relation/followings
+
+*请求方式：GET*
+
+认证方式：Cookie(SESSDATA)或APP
+
+登录可看自己全部，其他用户仅可查看前5页，可以获取已设置可见性隐私的关注列表
+
+**url参数：**
+
+| 参数名     | 类型 | 内容         | 必要性      | 备注                                                    |
+| ---------- | ---- | ------------ | ----------- | ------------------------------------------------------- |
+| access_key | str  | APP登录Token | APP方式必要 |                                                         |
+| vmid       | num  | 目标用户mid  | 必要        |                                                         |
+| order_type | str  | 排序方式     | 非必要      | 按照关注顺序排列：留空<br />按照最常访问排列：attention |
+| ps         | num  | 每页项数     | 非必要      | 默认为50                                                |
+| pn         | num  | 页码         | 非必要      | 默认为1<br />其他用户仅可查看前5页                      |
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型 | 内容     | 备注                                                         |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code    | num  | 返回值   | 0：成功<br />-400：请求错误<br />22007：访问超过5页 |
+| message | str  | 错误信息 | 默认为0                                                      |
+| ttl     | num  | 1        |                                                              |
+| data    | obj  | 信息本体 |                                                              |
+
+data 对象：
+
+| 字段       | 类型  | 内容     | 备注         |
+| ---------- | ----- | -------- | ------------ |
+| list       | array | 明细列表 |              |
+| re_version | num   | ？？？   | 作用尚不明确 |
+| total      | num   | 关注总数 |              |
+
+`data`中的`list`数组：
+
+| 项   | 类型 | 内容      | 备注             |
+| ---- | ---- | --------- | ---------------- |
+| 0    | obj  | 关注1     |                  |
+| n    | obj  | 关注(n+1) | 按照关注顺序排列 |
+| ……   | obj  | ……        | ……               |
+
+数组`list`中的对象：
+
+| 字段            | 类型                                     | 内容         | 备注                                    |
+| --------------- | ---------------------------------------- | ------------ | --------------------------------------- |
+| mid             | num                                      | 用户mid      |                                         |
+| attribute       | num                                      | 关注属性     | 0：未关注<br />2：已关注<br />6：已互粉 |
+| mtime           | num                                      | 关注对方时间 | 时间戳<br />互关后刷新                  |
+| tag             | 默认分组：null<br />存在至少一个分组：array | 分组id       |                             |
+| special         | num                                      | 特别关注标志 | 0：否<br />1：是                        |
+| uname           | str                                      | 用户昵称     |                                         |
+| face            | str                                      | 用户头像url  |                                         |
+| sign            | str                                      | 用户签名     |                                         |
+| official_verify | obj                                      | 认证信息     |                                         |
+| vip             | obj                                      | 会员信息     |                                         |
+
+数组`list`中的对象中的`tag`数组：
+
+| 项   | 类型 | 内容                  | 备注 |
+| ---- | ---- | --------------------- | ---- |
+| 0    | num  | 位于分组1的分组id     |      |
+| n    | num  | 位于分组(n+1)的分组id |      |
+| ……   | num  | ……                    | ……   |
+
+`list`中的对象中的`official_verify`对象：
+
+| 字段 | 类型 | 内容         | 备注                |
+| ---- | ---- | ------------ | ------------------- |
+| type | num  | 用户认证类型 | -1：无<br />1：认证 |
+| desc | str  | 用户认证信息 | 无为空              |
+
+`list`中的对象中的`vip`对象：
+
+| 字段          | 类型 | 内容         | 备注                                            |
+| ------------- | ---- | ------------ | ----------------------------------------------- |
+| vipType       | num  | 会员类型     | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
+| vipDueDate    | num  | 会员到期时间 | 时间戳 毫秒                                     |
+| dueRemark     | str  | 空           | 作用尚不明确                                    |
+| accessStatus  | num  | 0            | 作用尚不明确                                    |
+| vipStatus     | num  | 大会员状态   | 0：无<br />1：有                                |
+| vipStatusWarn | str  | 空           | 作用尚不明确                                    |
+| themeType     | num  | 0            | 作用尚不明确                                    |
+| label         | obj  | ？？？       | 作用尚不明确                                    |
+
+`vip`中的`label`对象：
+
+| 字段 | 类型 | 内容 | 备注         |
+| ---- | ---- | ---- | ------------ |
+| path | str  | 空   | 作用尚不明确 |
+
+**示例：**
+
+获取用户`mid=293793435`的关注明细，按照关注顺序
+
+```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'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+	"code": 0,
+	"message": "0",
+	"ttl": 1,
+	"data": {
+		"list": [{
+			"mid": 14082,
+			"attribute": 2,
+			"mtime": 1584271945,
+			"tag": null,
+			"special": 0,
+			"uname": "山新",
+			"face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg",
+			"sign": "都说了是天依爹地，不是妈咪。\r私信有点多回复不过来～商业合作啥的请移步Weibo私信@山新 哦哦哦～",
+			"official_verify": {
+				"type": 0,
+				"desc": "配音演员、声优。洛天依声源提供者。"
+			},
+			"vip": {
+				"vipType": 2,
+				"vipDueDate": 1601654400000,
+				"dueRemark": "",
+				"accessStatus": 0,
+				"vipStatus": 1,
+				"vipStatusWarn": "",
+				"themeType": 0,
+				"label": {
+					"path": ""
+				}
+			}
+		}, {
+			"mid": 420831218,
+			"attribute": 2,
+			"mtime": 1584208169,
+			"tag": [207542],
+			"special": 0,
+			"uname": "支付宝Alipay",
+			"face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg",
+			"sign": "阿支来了，关注点赞转发投币四连走起！",
+			"official_verify": {
+				"type": 1,
+				"desc": "支付宝官方账号"
+			},
+			"vip": {
+				"vipType": 1,
+				"vipDueDate": 1585065600000,
+				"dueRemark": "",
+				"accessStatus": 0,
+				"vipStatus": 1,
+				"vipStatusWarn": "",
+				"themeType": 0,
+				"label": {
+					"path": ""
+				}
+			}
+		}],
+		"re_version": 3228575555,
+		"total": 699
+	}
+}
+```
+
+</details>
+
 ## 搜索关注明细
 
 <img src="/imgs/relation.svg" width="100" height="100" />