From 2871403d48676002f6895826a72dc8625d6715e0 Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Sun, 26 Feb 2023 19:39:04 +0800 Subject: [PATCH] Update relation.md --- docs/user/relation.md | 123 +++++++++++++++++++++++++++++++++++------- 1 file changed, 104 insertions(+), 19 deletions(-) diff --git a/docs/user/relation.md b/docs/user/relation.md index b85cc9d..706eb55 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 | 每页项数 | 非必要 | 默认为50 | +| 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" +} +``` + +
+ ## 搜索关注明细