添加“查询互相关注明细”、“查询历史充电数据”API (#587)
* Update relation.md * Update relation.md * Update info.md * Update relation.md * Update relation.md * Update charge_list.md * Update charge_list.md
This commit is contained in:
wuziqian211
163
user/relation.md
163
user/relation.md
@@ -6,6 +6,7 @@
|
||||
- [搜索关注明细](#搜索关注明细)
|
||||
- [查询共同关注明细](#查询共同关注明细)
|
||||
- [查询悄悄关注明细](#查询悄悄关注明细)
|
||||
- [查询互相关注明细](#查询互相关注明细)
|
||||
- [查询黑名单明细](#查询黑名单明细)
|
||||
- [操作用户关系](#操作用户关系)
|
||||
- [批量操作用户关系](#批量操作用户关系)
|
||||
@@ -15,7 +16,7 @@
|
||||
- [关注分组相关](#关注分组相关)
|
||||
- [查询关注分组列表](#查询关注分组列表)
|
||||
- [查询关注分组明细](#查询关注分组明细)
|
||||
- [查询目标用户所在的分组](#查询目标用户所在的分组 )
|
||||
- [查询目标用户所在的分组](#查询目标用户所在的分组)
|
||||
- [查询所有特别关注的mid](#查询所有特别关注的mid)
|
||||
- [创建分组](#创建分组)
|
||||
- [重命名分组](#重命名分组)
|
||||
@@ -1027,6 +1028,166 @@ curl -G 'https://api.bilibili.com/x/relation/whispers' \
|
||||
|
||||
</details>
|
||||
|
||||
## 查询互相关注明细
|
||||
|
||||
<img src="/imgs/relation.svg" width="100" height="100" />
|
||||
|
||||
> https://api.bilibili.com/x/relation/friends
|
||||
|
||||
*请求方式：GET*
|
||||
|
||||
认证方式：Cookie(SESSDATA)或APP
|
||||
|
||||
查询与自己互关的用户明细，可看全部
|
||||
|
||||
**url参数：**
|
||||
|
||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||
| ---------- | ---- | ------------ | ----------- | -------- |
|
||||
| access_key | str | APP登录Token | APP方式必要 | |
|
||||
|
||||
**json回复：**
|
||||
|
||||
根对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ------- | ---- | -------- | ------------------------------------------------- |
|
||||
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
|
||||
| message | str | 错误信息 | 默认为0 |
|
||||
| ttl | num | 1 | |
|
||||
| data | obj | 信息本体 | |
|
||||
|
||||
data 对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ---------- | ----- | -------- | ------------ |
|
||||
| list | array | 明细列表 | |
|
||||
| re_version | num | ？？？ | 作用尚不明确 |
|
||||
|
||||
`data`中的`list`数组：
|
||||
|
||||
| 项 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | --------- | ---------------- |
|
||||
| 0 | obj | 互关1 | |
|
||||
| n | obj | 互关(n+1) | 按照关注顺序排列 |
|
||||
| …… | obj | …… | …… |
|
||||
|
||||
数组`list`中的对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
|
||||
| mid | num | 用户mid | |
|
||||
| attribute | num | 关注属性 | 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 | 空 | 作用尚不明确 |
|
||||
|
||||
**示例：**
|
||||
|
||||
获取互相关注明细
|
||||
|
||||
```shell
|
||||
curl -G 'https://api.bilibili.com/x/relation/friends' \
|
||||
-b 'SESSDATA=xxx'
|
||||
```
|
||||
|
||||
<details>
|
||||
<summary>查看响应示例：</summary>
|
||||
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"message": "0",
|
||||
"ttl": 1,
|
||||
"data": {
|
||||
"list": [
|
||||
{
|
||||
"mid": 293793435,
|
||||
"attribute": 6,
|
||||
"mtime": 1583817598,
|
||||
"tag": [-10],
|
||||
"special": 1,
|
||||
"uname": "社会易姐QwQ",
|
||||
"face": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
|
||||
"sign": "BAC项目负责人 | 带砖技术宅 | MC 编程 电子 | 车万众\u0026术术人 | 粉丝群1136462265 博客shakaianee.top",
|
||||
"face_nft": 0,
|
||||
"official_verify": {
|
||||
"type": -1,
|
||||
"desc": ""
|
||||
},
|
||||
"vip": {
|
||||
"vipType": 2,
|
||||
"vipDueDate": 1675872000000,
|
||||
"dueRemark": "",
|
||||
"accessStatus" :0,
|
||||
"vipStatus": 1,
|
||||
"vipStatusWarn": "",
|
||||
"themeType": 0,
|
||||
"label": {
|
||||
"path": "",
|
||||
"text": "年度大会员",
|
||||
"label_theme": "annual_vip",
|
||||
"text_color": "#FFFFFF",
|
||||
"bg_style": 1,
|
||||
"bg_color": "#FB7299",
|
||||
"border_color": ""
|
||||
},
|
||||
"avatar_subscript": 1,
|
||||
"nickname_color": "#FB7299",
|
||||
"avatar_subscript_url": ""
|
||||
},
|
||||
"nft_icon": "",
|
||||
"rec_reason": "",
|
||||
"track_id": ""
|
||||
}
|
||||
],
|
||||
"re_version": 0
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
## 查询黑名单明细
|
||||
|
||||
> https://api.bilibili.com/x/relation/blacks
|
||||
|
||||
Reference in New Issue
Block a user