From 9d504615a092710ac2fc00dfc44acbf070463fa0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=99=A8=E5=8F=B6=E6=A2=A6=E6=98=A5?=
<65224318+wuziqian211@users.noreply.github.com>
Date: Mon, 5 May 2025 02:43:30 +0800
Subject: [PATCH] feat(relation): #1264
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Signed-off-by: 晨叶梦春 <65224318+wuziqian211@users.noreply.github.com>
---
docs/user/relation.md | 2088 +++++++++++++++++++++++------------------
1 file changed, 1182 insertions(+), 906 deletions(-)
diff --git a/docs/user/relation.md b/docs/user/relation.md
index d9e5d43..2ecb74b 100644
--- a/docs/user/relation.md
+++ b/docs/user/relation.md
@@ -18,13 +18,15 @@
| contract_info | obj | 契约计划相关信息 | |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
-| face_nft | num | 是否为 NFT 头像 | 0:非 NFT 头像
1:NFT 头像 |
| sign | str | 用户签名 | |
+| face_nft | num | 是否为 NFT 头像 | 0:非 NFT 头像
1:NFT 头像 |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
+| name_render | 有效时:obj
无效时:null | 昵称渲染信息 | |
| nft_icon | str | (?) | |
-| rec_reason | str | (?) | |
-| track_id | str | (?) | |
+| rec_reason | str | 推荐该用户的原因 | 一般为空;如:`xxx关注了TA`、`xx粉丝 xx视频` |
+| track_id | str | 内部记录id | 一般为空;如:`up_rec_0.router-main-2021485-5f84c987cf-dv8fg.1746380060327.607` |
+| follow_time | str | (?) | |
`list`中的对象中的`tag`数组:
@@ -43,7 +45,6 @@
| ts | num | 对方成为目标用户的契约者的时间 | 秒级时间戳,仅当 `is_contractor` 项的值为 `true` 时才有此项 |
| user_attr | num | 对方作为目标用户的契约者的属性 | 1:老粉
否则为原始粉丝
仅当有特殊属性时才有此项 |
-
`list`中的对象中的`official_verify`对象:
| 字段 | 类型 | 内容 | 备注 |
@@ -70,9 +71,187 @@
| ---- | ---- | ------ | ---- |
| path | str | (?) | |
-### 查询用户粉丝明细
+### 查询用户粉丝明细(新)
-> https://api.bilibili.com/x/relation/followers
+>
+
+*请求方式:GET*
+
+认证方式:Cookie(SESSDATA)
+
+本接口只有登录、标头 `referer` 为 `bilibili.com` 下的子域名、UA 不含 `python` 时才会返回列表
+
+由于接口实现不同,本接口的返回可能出现以下三种情况:
+
+1. 返回列表按关注时间排序,此时当前用户**仅返回前 1000 名粉丝**,其他用户仅返回前 100 名粉丝,若继续往后查询则返回空列表
+2. 返回列表按粉丝 mid 的**文本形式**排序,此时对于任意用户均可返回全部粉丝
+3. 返回列表按照**智能推荐算法**排序,此时请求参数 `from=main` 且目标用户为自己,**仅返回前 1000 名粉丝**
+
+**url参数:**
+
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | -------------- | ------------ | ------------------------------------------------------------------- |
+| vmid | num | 目标用户 mid | 必要 | |
+| ps | num | 每页项数 | 非必要 | 默认为 50 |
+| pn | num | 页码 | 非必要 | 默认为 1 |
+| offset | str | 偏移量 | 非必要 | 此项有效且不为 `rcmd` 时会从此偏移量开始返回粉丝列表,忽略参数 `pn` |
+| from | str | 请求来源 | 非必要 | 当为 `main` 且目标用户为自己时,粉丝列表按照**智能推荐算法**排序,此时 `&.data.list[]` 中的 `rec_reason` 与 `track_id` 为非空 |
+
+**json回复:**
+
+根对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ----------------------------------------------------- |
+| code | num | 返回值 | 0:成功
-101:账号未登录
-352:请求被拦截
-400:请求错误
22118:由于该用户隐私设置,粉丝列表不可见 |
+| message | str | 错误信息 | 默认为 0 |
+| ttl | num | 1 | |
+| data | obj | 信息本体 | |
+
+`data`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---------- | ----- | -------- | ---- |
+| list | array | 明细列表 | |
+| offset | str | 偏移量 | 供下次请求使用
普通:`{列表最后的粉丝的 mtime}:{列表最后的粉丝的 mid}`
智能推荐算法:`rcmd` |
+| re_version | num | (?) | |
+| total | num | 粉丝总数 | |
+
+`data`中的`list`数组:
+
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | ------------ | ---------------------------------- |
+| 0 | obj | 粉丝 1 | 详见 [关系列表对象](#关系列表对象) |
+| n | obj | 粉丝 (n+1) | 按照添加顺序排列 |
+| …… | obj | …… | …… |
+
+**示例:**
+
+获取用户`mid=293793435`的粉丝明细
+
+```shell
+curl -G 'https://api.bilibili.com/x/relation/fans' \
+ --data-urlencode 'vmid=293793435' \
+ --data-urlencode 'ps=2' \
+ --data-urlencode 'pn=1' \
+ -b 'SESSDATA=xxx'
+```
+
+
+查看响应示例:
+
+```json
+{
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "list": [
+ {
+ "mid": 289796932,
+ "attribute": 0,
+ "mtime": 1746199088,
+ "tag": null,
+ "special": 0,
+ "contract_info": {
+
+ },
+ "uname": "Astlinga_星灵",
+ "face": "https://i1.hdslb.com/bfs/face/005264524d05c0b8c132acc3ee88bb839351025b.jpg",
+ "sign": "",
+ "face_nft": 0,
+ "official_verify": {
+ "type": -1,
+ "desc": ""
+ },
+ "vip": {
+ "vipType": 1,
+ "vipDueDate": 1734278400000,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 0,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": "",
+ "text": "",
+ "label_theme": "",
+ "text_color": "",
+ "bg_style": 0,
+ "bg_color": "",
+ "border_color": ""
+ },
+ "avatar_subscript": 0,
+ "nickname_color": "",
+ "avatar_subscript_url": ""
+ },
+ "name_render": {
+
+ },
+ "nft_icon": "",
+ "rec_reason": "",
+ "track_id": "",
+ "follow_time": ""
+ },
+ {
+ "mid": 3494375621396821,
+ "attribute": 0,
+ "mtime": 1746098997,
+ "tag": null,
+ "special": 0,
+ "contract_info": {
+
+ },
+ "uname": "JSRCode",
+ "face": "https://i1.hdslb.com/bfs/face/f6c74700c72d27ae224c5311634b4a3770e3cdcf.jpg",
+ "sign": "一个喜欢码代码的高中牲",
+ "face_nft": 0,
+ "official_verify": {
+ "type": -1,
+ "desc": ""
+ },
+ "vip": {
+ "vipType": 0,
+ "vipDueDate": 0,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 0,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": "",
+ "text": "",
+ "label_theme": "",
+ "text_color": "",
+ "bg_style": 0,
+ "bg_color": "",
+ "border_color": ""
+ },
+ "avatar_subscript": 0,
+ "nickname_color": "",
+ "avatar_subscript_url": ""
+ },
+ "name_render": {
+
+ },
+ "nft_icon": "",
+ "rec_reason": "",
+ "track_id": "",
+ "follow_time": ""
+ }
+ ],
+ "offset": "1746098997:3494375621396821",
+ "re_version": 0,
+ "total": 3776
+ }
+}
+```
+
+
+
+### 查询用户粉丝明细(旧)
+
+>
*请求方式:GET*
@@ -124,10 +303,10 @@
```shell
curl -G 'https://api.bilibili.com/x/relation/followers' \
- --data-urlencode 'vmid=293793435' \
- --data-urlencode 'ps=2' \
- --data-urlencode 'pn=1' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'vmid=293793435' \
+ --data-urlencode 'ps=2' \
+ --data-urlencode 'pn=1' \
+ -b 'SESSDATA=xxx'
```
@@ -135,64 +314,107 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "list": [{
- "mid": 387195656,
- "attribute": 0,
- "mtime": 1583839793,
- "tag": null,
- "special": 0,
- "uname": "L_E_M_O_H_E",
- "face": "https://i1.hdslb.com/bfs/face/8ec537db75eeb292faa8dc85a9ff8aba83148c86.jpg",
- "sign": "暂时断更。。Back later",
- "official_verify": {
- "type": -1,
- "desc": ""
- },
- "vip": {
- "vipType": 0,
- "vipDueDate": 0,
- "dueRemark": "",
- "accessStatus": 0,
- "vipStatus": 0,
- "vipStatusWarn": "",
- "themeType": 0,
- "label": {
- "path": ""
- }
- }
- }, {
- "mid": 175989424,
- "attribute": 0,
- "mtime": 1583822019,
- "tag": null,
- "special": 0,
- "uname": "哥本哈根iii",
- "face": "https://i1.hdslb.com/bfs/face/e53c0fe9315176d48bd294b1f381f0da70131cd7.jpg",
- "sign": "",
- "official_verify": {
- "type": -1,
- "desc": ""
- },
- "vip": {
- "vipType": 0,
- "vipDueDate": 0,
- "dueRemark": "",
- "accessStatus": 0,
- "vipStatus": 0,
- "vipStatusWarn": "",
- "themeType": 0,
- "label": {
- "path": ""
- }
- }
- }],
- "re_version": 3857745402,
- "total": 365
- }
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "list": [
+ {
+ "mid": 289796932,
+ "attribute": 0,
+ "mtime": 1746199088,
+ "tag": null,
+ "special": 0,
+ "contract_info": {
+
+ },
+ "uname": "Astlinga_星灵",
+ "face": "https://i1.hdslb.com/bfs/face/005264524d05c0b8c132acc3ee88bb839351025b.jpg",
+ "sign": "",
+ "face_nft": 0,
+ "official_verify": {
+ "type": -1,
+ "desc": ""
+ },
+ "vip": {
+ "vipType": 1,
+ "vipDueDate": 1734278400000,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 0,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": "",
+ "text": "",
+ "label_theme": "",
+ "text_color": "",
+ "bg_style": 0,
+ "bg_color": "",
+ "border_color": ""
+ },
+ "avatar_subscript": 0,
+ "nickname_color": "",
+ "avatar_subscript_url": ""
+ },
+ "name_render": {
+
+ },
+ "nft_icon": "",
+ "rec_reason": "",
+ "track_id": "",
+ "follow_time": ""
+ },
+ {
+ "mid": 3494375621396821,
+ "attribute": 0,
+ "mtime": 1746098997,
+ "tag": null,
+ "special": 0,
+ "contract_info": {
+
+ },
+ "uname": "JSRCode",
+ "face": "https://i1.hdslb.com/bfs/face/f6c74700c72d27ae224c5311634b4a3770e3cdcf.jpg",
+ "sign": "一个喜欢码代码的高中牲",
+ "face_nft": 0,
+ "official_verify": {
+ "type": -1,
+ "desc": ""
+ },
+ "vip": {
+ "vipType": 0,
+ "vipDueDate": 0,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 0,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": "",
+ "text": "",
+ "label_theme": "",
+ "text_color": "",
+ "bg_style": 0,
+ "bg_color": "",
+ "border_color": ""
+ },
+ "avatar_subscript": 0,
+ "nickname_color": "",
+ "avatar_subscript_url": ""
+ },
+ "name_render": {
+
+ },
+ "nft_icon": "",
+ "rec_reason": "",
+ "track_id": "",
+ "follow_time": ""
+ }
+ ],
+ "re_version": 0,
+ "total": 3776
+ }
}
```
@@ -200,7 +422,7 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \
### 查询用户关注明细
-> https://api.bilibili.com/x/relation/followings
+>
*请求方式:GET*
@@ -253,11 +475,11 @@ curl -G 'https://api.bilibili.com/x/relation/followers' \
```shell
curl -G 'https://api.bilibili.com/x/relation/followings' \
- --data-urlencode 'vmid=293793435' \
- --data-urlencode 'order_type=' \
- --data-urlencode 'ps=2' \
- --data-urlencode 'pn=1' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'vmid=293793435' \
+ --data-urlencode 'order_type=' \
+ --data-urlencode 'ps=2' \
+ --data-urlencode 'pn=1' \
+ -b 'SESSDATA=xxx'
```
@@ -265,64 +487,82 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
```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
- }
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "list": [{
+ "mid": 14082,
+ "attribute": 2,
+ "mtime": 1584271945,
+ "tag": null,
+ "special": 0,
+ "contract_info": {},
+ "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": ""
+ },
+ "avatar_subscript": 1,
+ "nickname_color": "#FB7299",
+ "avatar_subscript_url": ""
+ },
+ "name_render": {},
+ "nft_icon": "",
+ "rec_reason": "",
+ "track_id": "",
+ "follow_time": ""
+ }, {
+ "mid": 420831218,
+ "attribute": 2,
+ "mtime": 1584208169,
+ "tag": [207542],
+ "special": 0,
+ "contract_info": {},
+ "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": ""
+ },
+ "avatar_subscript": 1,
+ "nickname_color": "#FB7299",
+ "avatar_subscript_url": ""
+ },
+ "name_render": {},
+ "nft_icon": "",
+ "rec_reason": "",
+ "track_id": "",
+ "follow_time": ""
+ }],
+ "re_version": 0,
+ "total": 1028
+ }
}
```
@@ -330,7 +570,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
### 查询用户关注明细2
-> https://app.biliapi.net/x/v2/relation/followings
+>
*请求方式:GET*
@@ -386,7 +626,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
-| live | num | 是否直播 | 0:未直播
1:直播中 |
+| live | num | 是否直播 | 0:未直播
1:直播中 |
数组`list`中的对象中的`tag`数组:
@@ -428,9 +668,9 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \
```shell
curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
- --data-urlencode 'vmid=293793435' \
- --data-urlencode 'ps=2' \
- --data-urlencode 'pn=1' \
+ --data-urlencode 'vmid=293793435' \
+ --data-urlencode 'ps=2' \
+ --data-urlencode 'pn=1' \
```
@@ -438,64 +678,66 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
```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
- }
+ "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": ""
+ }
+ },
+ "live": 0
+ }, {
+ "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": ""
+ }
+ },
+ "live": 0
+ }],
+ "re_version": 3228575555,
+ "total": 699
+ }
}
```
@@ -503,7 +745,7 @@ 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*
@@ -545,12 +787,20 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
数组`list`中的对象:
-| 字段 | 类型 | 内容 | 备注 |
-| --------------- | ---- | ----------- | --------------------------------------- |
-| mid | str | 用户mid | |
-| attribute | num | 关注属性 | 0:未关注
2:已关注
6:已互粉 |
-| uname | str | 用户昵称 | |
-| face | str | 用户头像url | |
+| 字段 | 类型 | 内容 | 备注 |
+| ----------------- | ---- | ------------------------------ | --------------------------------------- |
+| mid | str | 用户mid | |
+| attribute | num | 对方对于**目标用户**的关注属性 | 0:未关注
2:已关注
6:已互粉 |
+| uname | str | 用户昵称 | |
+| face | str | 用户头像url | |
+| attention_display | obj | 用户认证信息 | |
+
+`attention_display`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | -------- | ------------------------------------------------------------ |
+| type | num | 是否认证 | 0:无
1:UP主专业认证
2:UP主认证
3:机构认证 |
+| desc | str | 认证信息 | |
**示例:**
@@ -558,9 +808,9 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
```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'
+ --data-urlencode 'vmid=293793435' \
+ --data-urlencode 'ps=2' \
+ --data-urlencode 'pn=1'
```
@@ -568,22 +818,24 @@ curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationsh
```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"
+ "code": 0,
+ "data": {
+ "list": [{
+ "mid": "14082",
+ "attribute": 2,
+ "uname": "山新",
+ "face": "https://i0.hdslb.com/bfs/face/74c82caee6d9eb623e56161ea8ed6d68afabfeae.jpg",
+ "attestation_display": { "type": 0, "desc": "" }
+ }, {
+ "mid": "420831218",
+ "attribute": 2,
+ "uname": "支付宝Alipay",
+ "face": "https://i2.hdslb.com/bfs/face/aaf18aeb2d9822e28a590bd8d878572ca8c59e04.jpg",
+ "attestation_display": { "type": 3, "desc": "bilibili机构认证:支付宝官方账号" }
+ }]
+ },
+ "ts": 1677410818395,
+ "request_id": "d9d541b9f2d24e21821e2d6d2d16c17d"
}
```
@@ -591,7 +843,7 @@ curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationsh
### 搜索关注明细
-> https://api.bilibili.com/x/relation/followings/search
+>
*请求方式:GET*
@@ -616,7 +868,7 @@ curl -G 'https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationsh
| ttl | num | 1 | |
| data | obj | 信息本体 | |
-data 对象:
+`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ---- |
@@ -638,11 +890,11 @@ data 对象:
```shell
curl -G 'https://api.bilibili.com/x/relation/followings/search' \
- --data-urlencode 'vmid=293793435' \
- --data-urlencode 'name=warma' \
- --data-urlencode 'ps=2' \
- --data-urlencode 'pn=1' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'vmid=293793435' \
+ --data-urlencode 'name=warma' \
+ --data-urlencode 'ps=2' \
+ --data-urlencode 'pn=1' \
+ -b 'SESSDATA=xxx'
```
@@ -650,42 +902,42 @@ curl -G 'https://api.bilibili.com/x/relation/followings/search' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "list": [
- {
- "mid": 53456,
- "attribute": 2,
- "mtime": 1586415053,
- "tag": [
- -10
- ],
- "special": 1,
- "uname": "Warma",
- "face": "https://i2.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg",
- "sign": "我是沃玛,做点傻开心的视频。日常发在微博:@_warma_ ",
- "official_verify": {
- "type": 0,
- "desc": "bilibili 知名UP主"
- },
- "vip": {
- "vipType": 2,
- "vipDueDate": 1637424000000,
- "dueRemark": "",
- "accessStatus": 0,
- "vipStatus": 1,
- "vipStatusWarn": "",
- "themeType": 0,
- "label": {
- "path": ""
- }
- }
- }
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "list": [
+ {
+ "mid": 53456,
+ "attribute": 2,
+ "mtime": 1586415053,
+ "tag": [
+ -10
],
- "total": 1
- }
+ "special": 1,
+ "uname": "Warma",
+ "face": "https://i2.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg",
+ "sign": "我是沃玛,做点傻开心的视频。日常发在微博:@_warma_ ",
+ "official_verify": {
+ "type": 0,
+ "desc": "bilibili 知名UP主"
+ },
+ "vip": {
+ "vipType": 2,
+ "vipDueDate": 1637424000000,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 1,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": ""
+ }
+ }
+ }
+ ],
+ "total": 1
+ }
}
```
@@ -693,7 +945,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings/search' \
### 查询共同关注明细
-> https://api.bilibili.com/x/relation/same/followings
+>
*请求方式:GET*
@@ -719,7 +971,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings/search' \
| ttl | num | 1 | |
| data | obj | 信息本体 | |
-data 对象:
+`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ---- |
@@ -741,10 +993,10 @@ data 对象:
```shell
curl -G 'https://api.bilibili.com/x/relation/same/followings' \
---data-urlencode 'vmid=2' \
---data-urlencode 'ps=2' \
---data-urlencode 'pn=1' \
--b 'SESSDATA=xxx'
+ --data-urlencode 'vmid=2' \
+ --data-urlencode 'ps=2' \
+ --data-urlencode 'pn=1' \
+ -b 'SESSDATA=xxx'
```
@@ -752,69 +1004,69 @@ curl -G 'https://api.bilibili.com/x/relation/same/followings' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "list": [
- {
- "mid": 116683,
- "attribute": 2,
- "mtime": 1564627532,
- "tag": null,
- "special": 0,
- "uname": "=咬人猫=",
- "face": "https://i0.hdslb.com/bfs/face/8fad84a4470f3d894d8f0dc95555ab8f2cb10a83.jpg",
- "sign": "面瘫女仆酱~小粗腿~事业线什么的!!吐槽你就输了!喵~",
- "official_verify": {
- "type": 0,
- "desc": "bilibili 2019百大UP主、高能联盟成员"
- },
- "vip": {
- "vipType": 2,
- "vipDueDate": 1618934400000,
- "dueRemark": "",
- "accessStatus": 0,
- "vipStatus": 1,
- "vipStatusWarn": "",
- "themeType": 0,
- "label": {
- "path": ""
- }
- }
- },
- {
- "mid": 517717593,
- "attribute": 2,
- "mtime": 1592126052,
- "tag": [
- 207542
- ],
- "special": 0,
- "uname": "上海爱丽丝幻乐团",
- "face": "https://i0.hdslb.com/bfs/face/851a9191cbe93e66304d7577c0f6f83834e52109.jpg",
- "sign": "日本同人社团 上海爱丽丝幻乐团",
- "official_verify": {
- "type": 0,
- "desc": "上海爱丽丝幻乐团官方账号"
- },
- "vip": {
- "vipType": 1,
- "vipDueDate": 1593792000000,
- "dueRemark": "",
- "accessStatus": 0,
- "vipStatus": 0,
- "vipStatusWarn": "",
- "themeType": 0,
- "label": {
- "path": ""
- }
- }
- }
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "list": [
+ {
+ "mid": 116683,
+ "attribute": 2,
+ "mtime": 1564627532,
+ "tag": null,
+ "special": 0,
+ "uname": "=咬人猫=",
+ "face": "https://i0.hdslb.com/bfs/face/8fad84a4470f3d894d8f0dc95555ab8f2cb10a83.jpg",
+ "sign": "面瘫女仆酱~小粗腿~事业线什么的!!吐槽你就输了!喵~",
+ "official_verify": {
+ "type": 0,
+ "desc": "bilibili 2019百大UP主、高能联盟成员"
+ },
+ "vip": {
+ "vipType": 2,
+ "vipDueDate": 1618934400000,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 1,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": ""
+ }
+ }
+ },
+ {
+ "mid": 517717593,
+ "attribute": 2,
+ "mtime": 1592126052,
+ "tag": [
+ 207542
],
- "re_version": 2498273968,
- "total": 38
- }
+ "special": 0,
+ "uname": "上海爱丽丝幻乐团",
+ "face": "https://i0.hdslb.com/bfs/face/851a9191cbe93e66304d7577c0f6f83834e52109.jpg",
+ "sign": "日本同人社团 上海爱丽丝幻乐团",
+ "official_verify": {
+ "type": 0,
+ "desc": "上海爱丽丝幻乐团官方账号"
+ },
+ "vip": {
+ "vipType": 1,
+ "vipDueDate": 1593792000000,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 0,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": ""
+ }
+ }
+ }
+ ],
+ "re_version": 2498273968,
+ "total": 38
+ }
}
```
@@ -822,7 +1074,7 @@ curl -G 'https://api.bilibili.com/x/relation/same/followings' \
### 查询悄悄关注明细
-> https://api.bilibili.com/x/relation/whispers
+>
*请求方式:GET*
@@ -845,7 +1097,7 @@ curl -G 'https://api.bilibili.com/x/relation/same/followings' \
| ttl | num | 1 | |
| data | obj | 信息本体 | |
-data 对象:
+`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ---- |
@@ -864,7 +1116,7 @@ data 对象:
```shell
curl -G 'https://api.bilibili.com/x/relation/whispers' \
- -b 'SESSDATA=xxx'
+ -b 'SESSDATA=xxx'
```
@@ -872,47 +1124,48 @@ curl -G 'https://api.bilibili.com/x/relation/whispers' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "list": [
- {
- "mid": 178429408,
- "attribute": 1,
- "mtime": 1605972105,
- "tag": null,
- "special": 0,
- "uname": "老弟一号",
- "face": "https://i2.hdslb.com/bfs/face/21426275f3d3149b96b88783275205ba574c09e3.jpg",
- "sign": "萌新硬件玩家,前垃圾佬~(◦˙▽˙◦某宝店 老弟一号 粉丝群679540094商务合作V13869651328",
- "official_verify": {
- "type": 0,
- "desc": "知识领域优质UP主"
- },
- "vip": {
- "vipType": 2,
- "vipDueDate": 1632499200000,
- "dueRemark": "",
- "accessStatus": 0,
- "vipStatus": 1,
- "vipStatusWarn": "",
- "themeType": 0,
- "label": {
- "path": ""
- }
- }
- }
- ],
- "re_version": 2137574562
- }
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "list": [
+ {
+ "mid": 178429408,
+ "attribute": 1,
+ "mtime": 1605972105,
+ "tag": null,
+ "special": 0,
+ "uname": "老弟一号",
+ "face": "https://i2.hdslb.com/bfs/face/21426275f3d3149b96b88783275205ba574c09e3.jpg",
+ "sign": "萌新硬件玩家,前垃圾佬~(◦˙▽˙◦某宝店 老弟一号 粉丝群679540094商务合作V13869651328",
+ "official_verify": {
+ "type": 0,
+ "desc": "知识领域优质UP主"
+ },
+ "vip": {
+ "vipType": 2,
+ "vipDueDate": 1632499200000,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 1,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": ""
+ }
+ }
+ }
+ ],
+ "re_version": 2137574562
+ }
}
```
+
### 查询互相关注明细
-> https://api.bilibili.com/x/relation/friends
+>
*请求方式:GET*
@@ -937,7 +1190,7 @@ curl -G 'https://api.bilibili.com/x/relation/whispers' \
| ttl | num | 1 | |
| data | obj | 信息本体 | |
-data 对象:
+`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ---- |
@@ -956,183 +1209,183 @@ data 对象:
```shell
curl -G 'https://api.bilibili.com/x/relation/friends' \
- -b 'SESSDATA=xxx'
+ -b 'SESSDATA=xxx'
```
查看响应示例:
-```json
+```jsonc
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "list": [
- {
- "mid": 596000,
- "attribute": 6,
- "mtime": 1685110154,
- "tag": null,
- "special": 0,
- "uname": "椛椛在睡觉",
- "face": "https://i2.hdslb.com/bfs/face/365c1ef3b2a3afe21d6832796338fad5119b2592.jpg",
- "sign": "欢迎来找椛椛玩~ https://blogs.momiji-jin.com/",
- "face_nft": 0,
- "official_verify": {
- "type": -1,
- "desc": ""
- },
- "vip": {
- "vipType": 2,
- "vipDueDate": 1702742400000,
- "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": ""
- },
- {
- "mid": 24022863,
- "attribute": 6,
- "mtime": 1685026230,
- "tag": [
- -10
- ],
- "special": 1,
- "uname": "黄禄轩电脑专用账号",
- "face": "https://i0.hdslb.com/bfs/face/a70ec7d2a3822980a915ef4b30371af0cbc79132.jpg",
- "sign": "若要私信,请私信「黄禄轩手机专用账号」http://space.bilibili.com/17640193/,群:410311648",
- "face_nft": 0,
- "official_verify": {
- "type": -1,
- "desc": ""
- },
- "vip": {
- "vipType": 2,
- "vipDueDate": 1686412800000,
- "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": ""
- },
- {
- "mid": 85438718,
- "attribute": 6,
- "mtime": 1684759843,
- "tag": [
- 194110
- ],
- "special": 0,
- "uname": "忘忧北萱草Official",
- "face": "https://i2.hdslb.com/bfs/face/68d8cba01aab907dbb2cf2e17074f20947156237.jpg",
- "sign": "现已加入 OrangeFire 豪华套餐!",
- "face_nft": 0,
- "official_verify": {
- "type": -1,
- "desc": ""
- },
- "vip": {
- "vipType": 2,
- "vipDueDate": 1691683200000,
- "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": ""
- },
- {
- "mid": 41620134,
- "attribute": 6,
- "mtime": 1684759649,
- "tag": null,
- "special": 0,
- "uname": "Tiggy_Chan",
- "face": "https://i0.hdslb.com/bfs/face/8c8d9f43eda207f8cb8503bfdf6cc3802a1cd6c1.jpg",
- "sign": "此号只发科技类视频,娱乐类转至:虎子酱233",
- "face_nft": 0,
- "official_verify": {
- "type": -1,
- "desc": ""
- },
- "vip": {
- "vipType": 1,
- "vipDueDate": 1669219200000,
- "dueRemark": "",
- "accessStatus": 0,
- "vipStatus": 0,
- "vipStatusWarn": "",
- "themeType": 0,
- "label": {
- "path": "",
- "text": "",
- "label_theme": "",
- "text_color": "",
- "bg_style": 0,
- "bg_color": "",
- "border_color": ""
- },
- "avatar_subscript": 0,
- "nickname_color": "",
- "avatar_subscript_url": ""
- },
- "nft_icon": "",
- "rec_reason": "",
- "track_id": ""
- },
- ……
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "list": [
+ {
+ "mid": 596000,
+ "attribute": 6,
+ "mtime": 1685110154,
+ "tag": null,
+ "special": 0,
+ "uname": "椛椛在睡觉",
+ "face": "https://i2.hdslb.com/bfs/face/365c1ef3b2a3afe21d6832796338fad5119b2592.jpg",
+ "sign": "欢迎来找椛椛玩~ https://blogs.momiji-jin.com/",
+ "face_nft": 0,
+ "official_verify": {
+ "type": -1,
+ "desc": ""
+ },
+ "vip": {
+ "vipType": 2,
+ "vipDueDate": 1702742400000,
+ "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": ""
+ },
+ {
+ "mid": 24022863,
+ "attribute": 6,
+ "mtime": 1685026230,
+ "tag": [
+ -10
],
- "re_version": 0
- }
+ "special": 1,
+ "uname": "黄禄轩电脑专用账号",
+ "face": "https://i0.hdslb.com/bfs/face/a70ec7d2a3822980a915ef4b30371af0cbc79132.jpg",
+ "sign": "若要私信,请私信「黄禄轩手机专用账号」http://space.bilibili.com/17640193/,群:410311648",
+ "face_nft": 0,
+ "official_verify": {
+ "type": -1,
+ "desc": ""
+ },
+ "vip": {
+ "vipType": 2,
+ "vipDueDate": 1686412800000,
+ "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": ""
+ },
+ {
+ "mid": 85438718,
+ "attribute": 6,
+ "mtime": 1684759843,
+ "tag": [
+ 194110
+ ],
+ "special": 0,
+ "uname": "忘忧北萱草Official",
+ "face": "https://i2.hdslb.com/bfs/face/68d8cba01aab907dbb2cf2e17074f20947156237.jpg",
+ "sign": "现已加入 OrangeFire 豪华套餐!",
+ "face_nft": 0,
+ "official_verify": {
+ "type": -1,
+ "desc": ""
+ },
+ "vip": {
+ "vipType": 2,
+ "vipDueDate": 1691683200000,
+ "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": ""
+ },
+ {
+ "mid": 41620134,
+ "attribute": 6,
+ "mtime": 1684759649,
+ "tag": null,
+ "special": 0,
+ "uname": "Tiggy_Chan",
+ "face": "https://i0.hdslb.com/bfs/face/8c8d9f43eda207f8cb8503bfdf6cc3802a1cd6c1.jpg",
+ "sign": "此号只发科技类视频,娱乐类转至:虎子酱233",
+ "face_nft": 0,
+ "official_verify": {
+ "type": -1,
+ "desc": ""
+ },
+ "vip": {
+ "vipType": 1,
+ "vipDueDate": 1669219200000,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 0,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": "",
+ "text": "",
+ "label_theme": "",
+ "text_color": "",
+ "bg_style": 0,
+ "bg_color": "",
+ "border_color": ""
+ },
+ "avatar_subscript": 0,
+ "nickname_color": "",
+ "avatar_subscript_url": ""
+ },
+ "nft_icon": "",
+ "rec_reason": "",
+ "track_id": ""
+ },
+ // ……
+ ],
+ "re_version": 0
+ }
}
```
@@ -1140,7 +1393,7 @@ curl -G 'https://api.bilibili.com/x/relation/friends' \
### 查询黑名单明细
-> https://api.bilibili.com/x/relation/blacks
+>
*请求方式:GET*
@@ -1165,7 +1418,7 @@ curl -G 'https://api.bilibili.com/x/relation/friends' \
| ttl | num | 1 | |
| data | obj | 信息本体 | |
-data 对象:
+`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | ------------ | ---- |
@@ -1187,9 +1440,9 @@ data 对象:
```shell
curl -G 'https://api.bilibili.com/x/relation/blacks' \
- --data-urlencode 'ps=2' \
- --data-urlencode 'pn=1' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'ps=2' \
+ --data-urlencode 'pn=1' \
+ -b 'SESSDATA=xxx'
```
@@ -1197,67 +1450,67 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "list": [
- {
- "mid": 22179720,
- "attribute": 128,
- "mtime": 1603032789,
- "tag": null,
- "special": 0,
- "uname": "咩2016",
- "face": "https://i0.hdslb.com/bfs/face/41fe435a7e62eae605a5908652f32f3afff2ae74.jpg",
- "sign": "",
- "official_verify": {
- "type": 0,
- "desc": ""
- },
- "vip": {
- "vipType": 0,
- "vipDueDate": 0,
- "dueRemark": "",
- "accessStatus": 0,
- "vipStatus": 0,
- "vipStatusWarn": "",
- "themeType": 0,
- "label": {
- "path": ""
- }
- }
- },
- {
- "mid": 16174624,
- "attribute": 128,
- "mtime": 1603026420,
- "tag": null,
- "special": 0,
- "uname": "其实死亡没有那么痛",
- "face": "https://i2.hdslb.com/bfs/face/79257f5a2e7194a71337ccca5927afba7706d316.jpg",
- "sign": "等我,我马上就来",
- "official_verify": {
- "type": 0,
- "desc": ""
- },
- "vip": {
- "vipType": 0,
- "vipDueDate": 0,
- "dueRemark": "",
- "accessStatus": 0,
- "vipStatus": 0,
- "vipStatusWarn": "",
- "themeType": 0,
- "label": {
- "path": ""
- }
- }
- }
- ],
- "re_version": 897205356,
- "total": 2
- }
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "list": [
+ {
+ "mid": 22179720,
+ "attribute": 128,
+ "mtime": 1603032789,
+ "tag": null,
+ "special": 0,
+ "uname": "咩2016",
+ "face": "https://i0.hdslb.com/bfs/face/41fe435a7e62eae605a5908652f32f3afff2ae74.jpg",
+ "sign": "",
+ "official_verify": {
+ "type": 0,
+ "desc": ""
+ },
+ "vip": {
+ "vipType": 0,
+ "vipDueDate": 0,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 0,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": ""
+ }
+ }
+ },
+ {
+ "mid": 16174624,
+ "attribute": 128,
+ "mtime": 1603026420,
+ "tag": null,
+ "special": 0,
+ "uname": "其实死亡没有那么痛",
+ "face": "https://i2.hdslb.com/bfs/face/79257f5a2e7194a71337ccca5927afba7706d316.jpg",
+ "sign": "等我,我马上就来",
+ "official_verify": {
+ "type": 0,
+ "desc": ""
+ },
+ "vip": {
+ "vipType": 0,
+ "vipDueDate": 0,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 0,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": ""
+ }
+ }
+ }
+ ],
+ "re_version": 897205356,
+ "total": 2
+ }
}
```
@@ -1269,7 +1522,7 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
### 操作用户关系
-> https://api.bilibili.com/x/relation/modify
+>
*请求方式:POST*
@@ -1313,11 +1566,11 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \
```shell
curl 'https://api.bilibili.com/x/relation/modify' \
- --data-urlencode 'fid=14082' \
- --data-urlencode 'act=1' \
- --data-urlencode 're_src=11' \
- --data-urlencode 'csrf=xxx' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'fid=14082' \
+ --data-urlencode 'act=1' \
+ --data-urlencode 're_src=11' \
+ --data-urlencode 'csrf=xxx' \
+ -b 'SESSDATA=xxx'
```
@@ -1325,9 +1578,9 @@ curl 'https://api.bilibili.com/x/relation/modify' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1
+ "code": 0,
+ "message": "0",
+ "ttl": 1
}
```
@@ -1335,7 +1588,7 @@ curl 'https://api.bilibili.com/x/relation/modify' \
### 批量操作用户关系
-> https://api.bilibili.com/x/relation/batch/modify
+>
*请求方式:POST*
@@ -1384,11 +1637,11 @@ curl 'https://api.bilibili.com/x/relation/modify' \
```shell
curl 'https://api.bilibili.com/x/relation/batch/modify' \
- --data-urlencode 'fid=1,2,3,4,5' \
- --data-urlencode 'act=1' \
- --data-urlencode 're_src=11' \
- --data-urlencode 'csrf=xxx' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'fid=1,2,3,4,5' \
+ --data-urlencode 'act=1' \
+ --data-urlencode 're_src=11' \
+ --data-urlencode 'csrf=xxx' \
+ -b 'SESSDATA=xxx'
```
@@ -1396,12 +1649,12 @@ curl 'https://api.bilibili.com/x/relation/batch/modify' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "failed_fids": []
- }
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "failed_fids": []
+ }
}
```
@@ -1429,7 +1682,7 @@ curl 'https://api.bilibili.com/x/relation/batch/modify' \
### 查询用户与自己关系(仅关注)
-> https://api.bilibili.com/x/relation
+>
*请求方式:GET*
@@ -1459,8 +1712,8 @@ curl 'https://api.bilibili.com/x/relation/batch/modify' \
```shell
curl -G 'https://api.bilibili.com/x/relation' \
- --data-urlencode 'fid=258150656' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'fid=258150656' \
+ -b 'SESSDATA=xxx'
```
@@ -1468,16 +1721,16 @@ curl -G 'https://api.bilibili.com/x/relation' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "mid": 258150656,
- "attribute": 2,
- "mtime": 1540659101,
- "tag": [-10],
- "special": 1
- }
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "mid": 258150656,
+ "attribute": 2,
+ "mtime": 1540659101,
+ "tag": [-10],
+ "special": 1
+ }
}
```
@@ -1485,9 +1738,9 @@ curl -G 'https://api.bilibili.com/x/relation' \
### 查询用户与自己关系(互相关系)
-> 接口1:https://api.bilibili.com/x/space/wbi/acc/relation
+> 接口1:
-> 接口2:https://api.bilibili.com/x/web-interface/relation
+> 接口2:
*请求方式:GET*
@@ -1495,7 +1748,7 @@ curl -G 'https://api.bilibili.com/x/relation' \
鉴权方式(仅接口1):[Wbi 签名](../misc/sign/wbi.md)
-~~该接口的旧版 API :https://api.bilibili.com/x/space/acc/relation~~(已废弃,不建议使用)
+~~该接口的旧版 API :~~(已废弃,不建议使用)
**url参数:**
@@ -1532,10 +1785,10 @@ Wbi 签名的 `wts`、`w_rid`生成方式详见 [Wbi 签名](../misc/sign/wbi.md
```shell
curl -G 'https://api.bilibili.com/x/space/acc/relation' \
- --data-urlencode 'mid=15858903' \
- --data-urlencode 'wts=1686015899' \
- --data-urlencode 'w_rid=e10a3c566c9be80a7cebe7bcdf262588' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'mid=15858903' \
+ --data-urlencode 'wts=1686015899' \
+ --data-urlencode 'w_rid=e10a3c566c9be80a7cebe7bcdf262588' \
+ -b 'SESSDATA=xxx'
```
@@ -1543,32 +1796,32 @@ curl -G 'https://api.bilibili.com/x/space/acc/relation' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "relation": {
- "mid": 15858903,
- "attribute": 6,
- "mtime": 1548311059,
- "tag": [
- -10,
- 194110,
- 248468
- ],
- "special": 1
- },
- "be_relation": {
- "mid": 293793435,
- "attribute": 6,
- "mtime": 1548311059,
- "tag": [
- 56502,
- -10
- ],
- "special": 1
- }
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "relation": {
+ "mid": 15858903,
+ "attribute": 6,
+ "mtime": 1548311059,
+ "tag": [
+ -10,
+ 194110,
+ 248468
+ ],
+ "special": 1
+ },
+ "be_relation": {
+ "mid": 293793435,
+ "attribute": 6,
+ "mtime": 1548311059,
+ "tag": [
+ 56502,
+ -10
+ ],
+ "special": 1
}
+ }
}
```
@@ -1576,7 +1829,7 @@ curl -G 'https://api.bilibili.com/x/space/acc/relation' \
### 批量查询用户与自己关系
-> https://api.bilibili.com/x/relation/relations
+>
*请求方式:GET*
@@ -1584,10 +1837,10 @@ curl -G 'https://api.bilibili.com/x/space/acc/relation' \
**url参数:**
-| 参数名 | 类型 | 内容 | 必要性 | 备注 |
-| ---------- | ---- | ------------ | ----------- | ------------------- |
-| access_key | str | APP 登录 Token | APP 方式必要 | |
-| fids | nums | 目标用户 mid | 必要 | 每个之间用`,`间隔 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ---------- | ---- | -------------- | ------------ | ----------------------------- |
+| access_key | str | APP 登录 Token | APP 方式必要 | |
+| fids | nums | 目标用户 mid | 必要 | 每个之间用`,`间隔,无成员限制 |
**json回复:**
@@ -1613,8 +1866,8 @@ curl -G 'https://api.bilibili.com/x/space/acc/relation' \
```shell
curl -G 'https://api.bilibili.com/x/relation/relations' \
---data-urlencode 'fid=258150656' \
--b 'SESSDATA=xxx'
+ --data-urlencode 'fid=258150656' \
+ -b 'SESSDATA=xxx'
```
@@ -1622,25 +1875,25 @@ curl -G 'https://api.bilibili.com/x/relation/relations' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "1": {
- "mid": 1,
- "attribute": 2,
- "mtime": 1601654227,
- "tag": null,
- "special": 0
- },
- "2": {
- "mid": 2,
- "attribute": 2,
- "mtime": 1601654225,
- "tag": null,
- "special": 0
- }
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "1": {
+ "mid": 1,
+ "attribute": 2,
+ "mtime": 1601654227,
+ "tag": null,
+ "special": 0
+ },
+ "2": {
+ "mid": 2,
+ "attribute": 2,
+ "mtime": 1601654225,
+ "tag": null,
+ "special": 0
}
+ }
}
```
@@ -1657,7 +1910,7 @@ curl -G 'https://api.bilibili.com/x/relation/relations' \
### 查询关注分组列表
-> https://api.bilibili.com/x/relation/tags
+>
*请求方式:GET*
@@ -1703,44 +1956,44 @@ curl -G 'https://api.bilibili.com/x/relation/relations' \
```shell
curl 'https://api.bilibili.com/x/relation/tags' \
- -b 'SESSDATA=xxx'
+ -b 'SESSDATA=xxx'
```
查看响应示例:
-```json
+```jsonc
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": [
- {
- "tagid": -10,
- "name": "特别关注",
- "count": 19,
- "tip": "第一时间收到该分组下用户更新稿件的通知"
- },
- {
- "tagid": 0,
- "name": "默认分组",
- "count": 340,
- "tip": ""
- },
- {
- "tagid": 194110,
- "name": "基友们",
- "count": 127,
- "tip": ""
- },
- {
- "tagid": 194111,
- "name": "我的同学",
- "count": 22,
- "tip": ""
- },
- …………
- ]
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": [
+ {
+ "tagid": -10,
+ "name": "特别关注",
+ "count": 19,
+ "tip": "第一时间收到该分组下用户更新稿件的通知"
+ },
+ {
+ "tagid": 0,
+ "name": "默认分组",
+ "count": 340,
+ "tip": ""
+ },
+ {
+ "tagid": 194110,
+ "name": "基友们",
+ "count": 127,
+ "tip": ""
+ },
+ {
+ "tagid": 194111,
+ "name": "我的同学",
+ "count": 22,
+ "tip": ""
+ },
+ // ……
+ ]
}
```
@@ -1748,7 +2001,7 @@ curl 'https://api.bilibili.com/x/relation/tags' \
### 查询关注分组明细
-> https://api.bilibili.com/x/relation/tag
+>
*请求方式:GET*
@@ -1770,54 +2023,77 @@ curl 'https://api.bilibili.com/x/relation/tags' \
根对象:
-| 字段 | 类型 | 内容 | 备注 |
-| ------- | ------ | -------- | ------------------------------------------------------------ |
-| code | num | 返回值 | 0:成功
-101:账号未登录
-400:请求错误
22104:该分组不存在 |
-| message | str | 错误信息 | 默认为 0 |
-| ttl | num | 1 | |
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ----- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0:成功
-101:账号未登录
-400:请求错误
22104:该分组不存在 |
+| message | str | 错误信息 | 默认为 0 |
+| ttl | num | 1 | |
| data | array | 成员列表 | |
`data`数组:
-| 项 | 类型 | 内容 | 备注 |
-| ---- | ---- | --------------- | -------------------------------- |
-| 0 | obj | 成员信息 1 | 见 [关系列表对象](#关系列表对象) |
-| n | obj | 成员信息(n+1) | 按照添加顺序排序 |
-| …… | obj | …… | …… |
+| 项 | 类型 | 内容 | 备注 |
+| ---- | ---- | --------------- | --------------------------------------- |
+| 0 | obj | 成员信息 1 | 与[关系列表对象](#关系列表对象)**不同** |
+| n | obj | 成员信息(n+1) | 按照添加顺序排序 |
+| …… | obj | …… | …… |
-`data` 中的对象:
+`data` 数组中的对象:
-| 字段 | 类型 | 内容 | 备注 |
-| --------------- | ---- | ----------- | -------------- |
-| mid | num | 用户id | |
-| attribute | num | 0 | |
-| tag | null | null | |
-| special | num | 0 | |
-| contract_info | json | 空的 | |
-| uname | str | 用户名 | |
-| face | str | 头像地址 | |
-| sign | str | 个人简介 | |
-| face_nft | int | ntf头像 | |
-| official_verify | json | 官方认证 | 具体见下 |
-| vip | json | 大会员 | 参考大会员文档 |
-| live | json | 直播状态 | 具体见下 |
-| nft_icon | str | 显示nft角标 | |
-| rec_reason | str | | |
-| track_id | str | | |
+| 字段 | 类型 | 内容 | 备注 |
+| --------------- | ---- | --------------- | -------------- |
+| mid | num | 用户mid | |
+| attribute | num | 关系属性 | 恒为 `0` |
+| tag | null | 关注分组id | 恒为 `null` |
+| special | num | 是否特别关注 | 恒为 `0` |
+| contract_info | obj | 契约计划信息 | |
+| uname | str | 用户昵称 | |
+| face | str | 用户头像url | |
+| sign | str | 用户签名 | |
+| face_nft | num | 是否为 NFT 头像 | |
+| official_verify | obj | 认证信息 | 具体见下 |
+| vip | obj | 会员信息 | |
+| live | obj | 直播状态 | 具体见下 |
+| nft_icon | str | (?) | |
+| rec_reason | str | (?) | |
+| track_id | str | (?) | |
+| follow_time | str | (?) | |
-`data`对象中的`official_verify`:
+`data`中的对象中的`official_verify`对象:
-| 字段 | 类型 | 内容 | 备注 |
-| ---- | ---- | ------------ | ---- |
-| type | num | 0 | |
-| desc | str | 官方认证内容 | |
+| 字段 | 类型 | 内容 | 备注 |
+| ---- | ---- | ------------ | ------------------- |
+| type | num | 用户认证类型 | -1:无
0:UP 主认证
1:机构认证 |
+| desc | str | 用户认证信息 | 无为空 |
-`data`对象中的`live`:
+`data`中的对象中的`vip`对象:
-| 字段 | 类型 | 内容 | 备注 |
-| ----------- | ---- | -------- | -------------------- |
-| live_status | num | 0或1 | 0:未开播,1:已直播 |
-| jump_url | str | 直播链接 |
+| 字段 | 类型 | 内容 | 备注 |
+| ------------- | ---- | ------------ | ----------------------------------------------- |
+| vipType | num | 会员类型 | 0:无
1:月度大会员
2:年度以上大会员 |
+| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
+| dueRemark | str | (?) | |
+| accessStatus | num | (?) | |
+| vipStatus | num | 大会员状态 | 0:无
1:有 |
+| vipStatusWarn | str | (?) | |
+| themeType | num | (?) | |
+| label | obj | (?) | |
+
+`data`数组中的对象中的`live`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ----------- | ---- | -------- | ------------------------ |
+| live_status | num | 直播状态 | 0:未开播
1:已直播 |
+| jump_url | str | 直播链接 | |
+
+`data`数组中的对象中的`contract_info`对象:
+
+| 字段 | 类型 | 内容 | 备注 |
+| ------------- | ---- | ------------------------------ | ----------------------------------------------------------- |
+| is_contract | bool | 目标用户是否为对方的契约者 | 仅当为 `true` 时才有此项 |
+| is_contractor | bool | 对方是否为目标用户的契约者 | 仅当为 `true` 时才有此项 |
+| ts | num | 对方成为目标用户的契约者的时间 | 秒级时间戳,仅当 `is_contractor` 项的值为 `true` 时才有此项 |
+| user_attr | num | 对方作为目标用户的契约者的属性 | 1:老粉
否则为原始粉丝
仅当有特殊属性时才有此项 |
**示例:**
@@ -1825,11 +2101,11 @@ curl 'https://api.bilibili.com/x/relation/tags' \
```shell
curl -G 'https://api.bilibili.com/x/relation/tag' \
- --data-urlencode 'tagid=207542' \
- --data-urlencode 'order_type=' \
- --data-urlencode 'ps=2' \
- --data-urlencode 'pn=1' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'tagid=207542' \
+ --data-urlencode 'order_type=' \
+ --data-urlencode 'ps=2' \
+ --data-urlencode 'pn=1' \
+ -b 'SESSDATA=xxx'
```
@@ -1837,60 +2113,60 @@ curl -G 'https://api.bilibili.com/x/relation/tag' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": [{
- "mid": 420831218,
- "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": ""
- }
- }
- }, {
- "mid": 125086406,
- "uname": "MSI微星科技",
- "face": "https://i1.hdslb.com/bfs/face/a844760e4e491677615b39399bc761e74c579bb4.jpg",
- "sign": "你好,这里是微星显卡官方!专注显卡三十年,欢迎私信咨询或提问MSI",
- "official_verify": {
- "type": 1,
- "desc": "微星科技官方账号"
- },
- "vip": {
- "vipType": 1,
- "vipDueDate": 1540656000000,
- "dueRemark": "",
- "accessStatus": 0,
- "vipStatus": 0,
- "vipStatusWarn": "",
- "themeType": 0,
- "label": {
- "path": ""
- }
- }
- }]
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": [{
+ "mid": 420831218,
+ "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": ""
+ }
+ }
+ }, {
+ "mid": 125086406,
+ "uname": "MSI微星科技",
+ "face": "https://i1.hdslb.com/bfs/face/a844760e4e491677615b39399bc761e74c579bb4.jpg",
+ "sign": "你好,这里是微星显卡官方!专注显卡三十年,欢迎私信咨询或提问MSI",
+ "official_verify": {
+ "type": 1,
+ "desc": "微星科技官方账号"
+ },
+ "vip": {
+ "vipType": 1,
+ "vipDueDate": 1540656000000,
+ "dueRemark": "",
+ "accessStatus": 0,
+ "vipStatus": 0,
+ "vipStatusWarn": "",
+ "themeType": 0,
+ "label": {
+ "path": ""
+ }
+ }
+ }]
}
```
-### 查询目标用户所在的分组
+### 查询目标用户所在的分组
-> https://api.bilibili.com/x/relation/tag/user
+>
*请求方式:GET*
@@ -1927,8 +2203,8 @@ curl -G 'https://api.bilibili.com/x/relation/tag' \
```shell
curl -G 'https://api.bilibili.com/x/relation/tag/user' \
- --data-urlencode 'fid=319214221' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'fid=319214221' \
+ -b 'SESSDATA=xxx'
```
@@ -1936,13 +2212,13 @@ curl -G 'https://api.bilibili.com/x/relation/tag/user' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "-10": "特别关注",
- "194111": "我的同学"
- }
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "-10": "特别关注",
+ "194111": "我的同学"
+ }
}
```
@@ -1950,7 +2226,7 @@ curl -G 'https://api.bilibili.com/x/relation/tag/user' \
### 查询所有特别关注 mid
-> https://api.bilibili.com/x/relation/tag/special
+>
*请求方式:GET*
@@ -1985,7 +2261,7 @@ curl -G 'https://api.bilibili.com/x/relation/tag/user' \
```shell
curl 'https://api.bilibili.com/x/relation/tag/special' \
- -b 'SESSDATA=xxx'
+ -b 'SESSDATA=xxx'
```
@@ -1993,29 +2269,29 @@ curl 'https://api.bilibili.com/x/relation/tag/special' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": [
- 500716647,
- 32832243,
- 53456,
- 25944552,
- 301839556,
- 427494870,
- 319214221,
- 31949159,
- 382666849,
- 258318451,
- 15858903,
- 54992199,
- 3379951,
- 392279807,
- 23215368,
- 258150656,
- 20165629,
- 22179720
- ]
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": [
+ 500716647,
+ 32832243,
+ 53456,
+ 25944552,
+ 301839556,
+ 427494870,
+ 319214221,
+ 31949159,
+ 382666849,
+ 258318451,
+ 15858903,
+ 54992199,
+ 3379951,
+ 392279807,
+ 23215368,
+ 258150656,
+ 20165629,
+ 22179720
+ ]
}
```
@@ -2025,7 +2301,7 @@ curl 'https://api.bilibili.com/x/relation/tag/special' \
-> https://api.bilibili.com/x/relation/tag/create
+>
*请求方式:POST*
@@ -2062,9 +2338,9 @@ curl 'https://api.bilibili.com/x/relation/tag/special' \
```shell
curl 'https://api.bilibili.com/x/relation/tag/create' \
- --data-urlencode 'tag=测试' \
- --data-urlencode 'csrf=xxx' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'tag=测试' \
+ --data-urlencode 'csrf=xxx' \
+ -b 'SESSDATA=xxx'
```
@@ -2072,12 +2348,12 @@ curl 'https://api.bilibili.com/x/relation/tag/create' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1,
- "data": {
- "tagid": 216677
- }
+ "code": 0,
+ "message": "0",
+ "ttl": 1,
+ "data": {
+ "tagid": 216677
+ }
}
```
@@ -2085,7 +2361,7 @@ curl 'https://api.bilibili.com/x/relation/tag/create' \
### 重命名分组
-> https://api.bilibili.com/x/relation/tag/update
+>
*请求方式:POST*
@@ -2116,10 +2392,10 @@ curl 'https://api.bilibili.com/x/relation/tag/create' \
```shell
curl 'https://api.bilibili.com/x/relation/tag/update' \
- --data-urlencode 'tagid=194112' \
- --data-urlencode 'name=膜法师' \
- --data-urlencode 'csrf=xxx' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'tagid=194112' \
+ --data-urlencode 'name=膜法师' \
+ --data-urlencode 'csrf=xxx' \
+ -b 'SESSDATA=xxx'
```
@@ -2127,9 +2403,9 @@ curl 'https://api.bilibili.com/x/relation/tag/update' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1
+ "code": 0,
+ "message": "0",
+ "ttl": 1
}
```
@@ -2139,7 +2415,7 @@ curl 'https://api.bilibili.com/x/relation/tag/update' \
-> https://api.bilibili.com/x/relation/tag/del
+>
*请求方式:POST*
@@ -2169,9 +2445,9 @@ curl 'https://api.bilibili.com/x/relation/tag/update' \
```shell
curl 'https://api.bilibili.com/x/relation/tag/del' \
- --data-urlencode 'tagid=216699' \
- --data-urlencode 'csrf=xxx' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'tagid=216699' \
+ --data-urlencode 'csrf=xxx' \
+ -b 'SESSDATA=xxx'
```
@@ -2179,9 +2455,9 @@ curl 'https://api.bilibili.com/x/relation/tag/del' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1
+ "code": 0,
+ "message": "0",
+ "ttl": 1
}
```
@@ -2191,7 +2467,7 @@ curl 'https://api.bilibili.com/x/relation/tag/del' \
-> https://api.bilibili.com/x/relation/tags/addUsers
+>
*请求方式:POST*
@@ -2224,10 +2500,10 @@ curl 'https://api.bilibili.com/x/relation/tag/del' \
```shell
curl 'https://api.bilibili.com/x/relation/tags/addUsers' \
- --data-urlencode 'fids=205631797' \
- --data-urlencode 'tagids=-10,207542' \
- --data-urlencode 'csrf=xxx' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'fids=205631797' \
+ --data-urlencode 'tagids=-10,207542' \
+ --data-urlencode 'csrf=xxx' \
+ -b 'SESSDATA=xxx'
```
@@ -2235,9 +2511,9 @@ curl 'https://api.bilibili.com/x/relation/tags/addUsers' \
```json
{
- "code": 0,
- "message": "0",
- "ttl": 1
+ "code": 0,
+ "message": "0",
+ "ttl": 1
}
```
@@ -2245,7 +2521,7 @@ curl 'https://api.bilibili.com/x/relation/tags/addUsers' \
### 复制关注到分组
-> https://api.bilibili.com/x/relation/tags/copyUsers
+>
*请求方式:POST*
@@ -2276,10 +2552,10 @@ curl 'https://api.bilibili.com/x/relation/tags/addUsers' \
```shell
curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \
- --data-urlencode 'fids=4856007,326499679' \
- --data-urlencode 'tagids=231305' \
- --data-urlencode 'csrf=xxx' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'fids=4856007,326499679' \
+ --data-urlencode 'tagids=231305' \
+ --data-urlencode 'csrf=xxx' \
+ -b 'SESSDATA=xxx'
```
@@ -2287,9 +2563,9 @@ curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \
```json
{
- "code":0,
- "message":"0",
- "ttl":1
+ "code": 0,
+ "message": "0",
+ "ttl": 1
}
```
@@ -2297,7 +2573,7 @@ curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \
### 移动关注到分组
-> https://api.bilibili.com/x/relation/tags/moveUsers
+>
*请求方式:POST*
@@ -2329,11 +2605,11 @@ curl 'https://api.bilibili.com/x/relation/tags/copyUsers' \
```shell
curl 'https://api.bilibili.com/x/relation/tags/moveUsers' \
- --data-urlencode 'beforeTagids=207542' \
- --data-urlencode 'afterTagids=23130' \
- --data-urlencode 'fids=321173469,327086920' \
- --data-urlencode 'csrf=xxx' \
- -b 'SESSDATA=xxx'
+ --data-urlencode 'beforeTagids=207542' \
+ --data-urlencode 'afterTagids=23130' \
+ --data-urlencode 'fids=321173469,327086920' \
+ --data-urlencode 'csrf=xxx' \
+ -b 'SESSDATA=xxx'
```
@@ -2341,9 +2617,9 @@ curl 'https://api.bilibili.com/x/relation/tags/moveUsers' \
```json
{
- "code":0,
- "message":"0",
- "ttl":1
+ "code": 0,
+ "message": "0",
+ "ttl": 1
}
```