github-repos/bilibili-API-collect
1
0
Fork 0
mirror of https://github.com/SocialSisterYi/bilibili-API-collect.git synced 2025-01-04 08:50:07 +08:00
Code Issues Packages Projects Releases Wiki Activity
b12bbd5ddd
bilibili-API-collect/user/relation.md

36 KiB
Raw Blame History

用户关系相关

查询用户粉丝明细

http://api.bilibili.com/x/relation/followers

方式:GET

登录(SESSDATA)可看自己全部

参数：

参数名 类型 内容 必要性 备注
vmid url 目标用户UID 必要
ps url 每页项数 非必要 默认为50
pn url 页码 非必要 默认为1
非自己仅可查看前5页

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
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 用户UID
attribute num 关注属性 0：未关注
2：已关注
6：已互粉
mtime num 成为粉丝时间 时间戳
互关后刷新
tag null 作用尚不明确
special num 0 作用尚不明确
uname str 用户昵称
face str 用户头像url
sign str 用户签名
official_verify obj 认证信息
vip obj 会员信息

数组list中的对象中的official_verify对象：

字段 类型 内容 备注
type num 用户认证类型 -1：无
1：认证
desc str 用户认证信息 无为空

数组list中的对象中的vip对象：

字段 类型 内容 备注
vipType num 大会员类型 0：无
1：月会员
2：年会员
vipDueDate num 会员到期时间 时间戳 毫秒
dueRemark str 空 作用尚不明确
accessStatus num 0 作用尚不明确
vipStatus num 大会员状态 0：无
1：有
vipStatusWarn str 空 作用尚不明确
themeType num 0 作用尚不明确
label obj ？？？ 作用尚不明确

vip中的label对象：

字段 类型 内容 备注
path str 空 作用尚不明确

示例：

以每页2项的方式获取UID=293793435的用户的第1页的粉丝明细

http://api.bilibili.com/x/relation/followers?vmid=293793435&ps=2&pn=1

{
	"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": "http://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": "http://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
	}
}

查询用户关注明细

http://api.bilibili.com/x/relation/followings

方式:GET

登录(SESSDATA)可看自己全部

参数：

参数名 类型 内容 必要性 备注
vmid url 目标用户UID 必要
ps url 每页项数 非必要 默认为50
pn url 页码 非必要 默认为1
非自己仅可查看前5页

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
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 用户UID
attribute num 关注属性 0：未关注
2：已关注
6：已互粉
mtime num 关注对方时间 时间戳
互关后刷新
tag null默认分组
arrary存在至少一个分组		 分组ID 作用尚不明确
special num 特别关注标志 0：否
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：无
0：认证
desc str 用户认证信息 无为空

数组list中的对象中的vip对象：

字段 类型 内容 备注
vipType num 大会员类型 0：无
1：月会员
2：年会员
vipDueDate num 会员到期时间 时间戳 毫秒
dueRemark str 空 作用尚不明确
accessStatus num 0 作用尚不明确
vipStatus num 大会员状态 0：无
1：有
vipStatusWarn str 空 作用尚不明确
themeType num 0 作用尚不明确
label obj ？？？ 作用尚不明确

vip中的label对象：

字段 类型 内容 备注
path str 空 作用尚不明确

示例：

以每页2项的方式获取UID=293793435的用户的第1页的关注明细

http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"list": [{
			"mid": 14082,
			"attribute": 2,
			"mtime": 1584271945,
			"tag": null,
			"special": 0,
			"uname": "山新",
			"face": "http://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": "http://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
	}
}

操作用户关系（关注/取关 等）

http://api.bilibili.com/x/relation/modify

方式:POST

需要登录(SESSDATA)

参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
fid data 目标用户UID 必要
act data 操作代码 必要 操作代码见下表
re_src data 必须为11 必要
csrf data cookies中的bili_jct 必要

操作代码act：

代码 含义
1 关注
2 取关
3 悄悄关注
4 取消悄悄关注
5 拉黑
6 取消拉黑
7 踢出粉丝

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
22003：用户位于黑名单
message str 错误信息 默认为0
ttl num 1 作用尚不明确

示例：

关注UID=14082的用户

curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" "http://api.bilibili.com/x/relation/modify"

{
	"code": 0,
	"message": "0",
	"ttl": 1
}

查询用户与自己关系1 (仅查关注)

http://api.bilibili.com/x/relation

方式:GET

需要登录(SESSDATA)

参数：

参数名 类型 内容 必要性 备注
fid url 目标用户UID 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-400：请求错误
message str 错误信息 默认为0
ttl num 1 作用尚不明确
data obj 信息本体

data对象：

字段 类型 内容 备注
mid num 目标用户UID
attribute num 关注属性 0：未关注
2：已关注
6：已互粉
mtime num 关注对方时间 时间戳
未关注为0
tag null默认分组
arrary存在至少一个分组		 分组ID
special num 特别关注标志 0：否
1：是

tag数组：

项 类型 内容 备注
0 num 位于分组1的分组ID
n num 位于分组（n+1）的分组ID
…… num …… ……

示例：

可得对于UID=258150656的用户，在2018/10/28 0:51:41时关注，且设为特别关注，并位于ID为-10分组中

http://api.bilibili.com/x/relation?fid=258150656

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"mid": 258150656,
		"attribute": 2,
		"mtime": 1540659101,
		"tag": [-10],
		"special": 1
	}
}

查询用户与自己关系2(互相)

http://api.bilibili.com/x/space/acc/relation

方式:GET

需要登录(SESSDATA)

参数：

参数名 类型 内容 必要性 备注
mid url 目标用户UID 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-400：请求错误
message str 错误信息 默认为0
ttl num 1 作用尚不明确
data obj 信息本体

data对象：

字段 类型 内容 备注
relation obj 目标用户对于本用户的属性
be_relation obj 本用户对于目标用户的属性

data中的relation对象：

字段 类型 内容 备注
mid num 对方用户UID
attribute num
mtime num 关注对方时间 互关后刷新时间
tag null默认分组
arrary存在至少一个分组
special num

data中的be_relation对象：

字段 类型 内容 备注
mid num
attribute num
mtime num 成为粉丝时间 互关后刷新时间
tag null默认分组
arrary存在至少一个分组
special num

be_relation与relation中的tag数组：

项 类型 内容 备注
0 num 位于分组1的分组ID
n num 位于分组（n+1）的分组ID
…… num …… ……

示例：

可得对于UID=15858903的用户，在2019/1/24 14:24:19时关注了对方，且互相关注，自己将对方特别关注，并同时位于ID为-10和194110的分组中，对方也将自己设为特别关注，并同时位于ID为-10和56502的分组中（虽然我看不到）

http://api.bilibili.com/x/space/acc/relation?mid=15858903

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"relation": {
			"mid": 15858903,
			"attribute": 6,
			"mtime": 1548311059,
			"tag": [-10, 194110],
			"special": 1,
			"is_followed": false
		},
		"be_relation": {
			"mid": 293793435,
			"attribute": 6,
			"mtime": 1548311059,
			"tag": [56502, -10],
			"special": 1,
			"is_followed": false
		}
	}
}

关注分组相关

查询关注分组列表

http://api.bilibili.com/x/relation/tags

方式:GET

需要登录(SESSDATA)

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
message str 错误信息 默认为0
ttl num 1 作用尚不明确
data arrary 分组列表

data数组：

项 类型 内容 备注
0 obj 特别关注分组
1 obj 默认分组
n obj 其他分组
…… num …… ……

数组data中的对象：

字段 类型 内容 备注
tagid num 分组ID 特别关注恒为-10
默认分组恒为0
name str 分组名称
count num 分组成员数

示例：

查询所有的分组的名字以及ID

http://api.bilibili.com/x/relation/tags

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": [{
		"tagid": -10,
		"name": "特别关注",
		"count": 16
	}, {
		"tagid": 0,
		"name": "默认分组",
		"count": 536
	},{
		"tagid": 194111,
		"name": "我的同学",
		"count": 16
	},
	…………
	]
}

查询关注分组明细

http://api.bilibili.com/x/relation/tag

方式:GET

需要登录(SESSDATA)

参数：

参数名 类型 内容 必要性 备注
tagid url 分组ID 必要 特别关注恒为-10
默认分组恒为0
ps url 每页项数 非必要 默认为50
pn url 页数 非必要 默认为1

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-400：请求错误
22104：该分组不存在
-101：账号未登录
message str 错误信息 默认为0
ttl num 1 作用尚不明确
data arrary 成员列表

data数组：

项 类型 内容 备注
0 obj 成员信息1
n obj 成员信息n 按照添加顺序排序
…… num …… ……

数组data中的对象：

字段 类型 内容 备注
mid num 用户UID
uname str 用户昵称
face str 用户头像url
sign str 用户签名
official_verify obj 认证信息
vip obj 会员信息

数组data中的对象中的official_verify对象：

字段 类型 内容 备注
type num 用户认证类型 -1：无
1：认证
desc str 用户认证信息 无为空

数组data中的对象中的vip对象：

字段 类型 内容 备注
vipType num 大会员类型 0：无
1：月会员
2：年会员
vipDueDate num 会员到期时间 毫秒 时间戳
dueRemark str 空 作用尚不明确
accessStatus num 0 作用尚不明确
vipStatus num 大会员状态 0无
1有
vipStatusWarn str 空 作用尚不明确
themeType num 0 作用尚不明确
label obj ？？？ 作用尚不明确

数组data中的对象中的label对象：

字段 类型 内容 备注
path str 空 作用尚不明确

示例：

以每页2项的方式获取了ID为207542分组的第1页的粉丝明细

http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": [{
		"mid": 420831218,
		"uname": "支付宝Alipay",
		"face": "http://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": "http://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": ""
			}
		}
	}]
}

查询目标用户所在的分组

http://api.bilibili.com/x/relation/tag/user

方式:GET

需要登录(SESSDATA)

参数：

参数名 类型 内容 必要性 备注
fid url 目标用户UID 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-101：账号未登录
-400：请求错误
message str 错误信息 默认为0
ttl num 1 作用尚不明确
data obj 信息本体

data对象：

字段 类型 内容 备注
｛加入的分组ID 1｝ str 分组1名称
｛加入的分组ID n｝ str 分组n名称
…… str ……

示例：

查询用户UID=319214221存在的所有分组ID和名称

http://api.bilibili.com/x/relation/tag/user?fid=319214221

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"-10": "特别关注",
		"194111": "我的同学"
	}
}

创建关注分组

http://api.bilibili.com/x/relation/tag/create

方式:POST

需要登录(SESSDATA)

参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
tag data 分组名 必要 最长16字符
csrf data cookies中的bili_jct 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22106：该分组已经存在
22103：分组名过长
message str 错误信息 默认为0
ttl num 1 作用尚不明确
data obj 信息本体

data对象：

字段 类型 内容 备注
tagid num 创建的分组的ID

示例：

创建了名为vUP的分组，得到ID为216677

curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" "http://api.bilibili.com/x/relation/tag/create"

{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": {
		"tagid": 216677
	}
}

重命名关注分组

http://api.bilibili.com/x/relation/tag/update

方式:POST

需要登录(SESSDATA)

参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
tagid data 分组ID 必要
name data 新名称 必要 最长16字符
csrf data cookies中的bili_jct 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22103：分组名过长
22104：该分组不存在
message str 错误信息 默认为0
ttl num 1 作用尚不明确

示例：

把ID为194112的分组更名为膜法师

curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx" "http://api.bilibili.com/x/relation/tag/update"

{
	"code": 0,
	"message": "0",
	"ttl": 1
}

删除关注分组

http://api.bilibili.com/x/relation/tag/del

方式:POST

需要登录(SESSDATA)

参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
tagid data 分组ID 必要
csrf data cookies中的bili_jct 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
message str 错误信息 默认为0
ttl num 1 作用尚不明确

示例：

删除分组ID为216699的分组

curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" "http://api.bilibili.com/x/relation/tag/del"

{
	"code": 0,
	"message": "0",
	"ttl": 1
}

修改用户分组关系（添加/删除）

http://api.bilibili.com/x/relation/tags/addUsers

方式:POST

需要登录(SESSDATA)

参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
fids data 目标用户UID 必要 每个ID之间用","（%2C）间隔
tagids data 分组ID 必要 每个ID之间用","（%2C）间隔
csrf data cookies中的bili_jct 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注
message str 错误信息 默认为0
ttl num 1 作用尚不明确

示例：

把关注用户UID=205631797同时添加分组关系到ID为-10和207542的分组中

curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" "http://api.bilibili.com/x/relation/tags/addUsers"

{
	"code": 0,
	"message": "0",
	"ttl": 1
}

批量复制关注用户到分组

http://api.bilibili.com/x/relation/tags/copyUsers

方式:POST

需要登录(SESSDATA)

参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
fids data 目标用户UID 必要 每个ID之间用","（%2C）间隔
tagids data 分组ID 必要 每个ID之间用","（%2C）间隔
csrf data cookies中的bili_jct 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注
message str 错误信息 默认为0
ttl num 1 作用尚不明确

示例：

把关注用户UID=4856007和UID=326499679同时复制到ID为231305的分组中

curl -b SESSDATA=xxx -d "fids=4856007%2C326499679&tagids=231305&csrf=xxx" "http://api.bilibili.com/x/relation/tags/copyUsers"

{
    "code":0,
    "message":"0",
    "ttl":1
}

批量移动关注用户到分组

http://api.bilibili.com/x/relation/tags/moveUsers

方式:POST

需要登录(SESSDATA)

参数（ application/x-www-form-urlencoded ）：

参数名 类型 内容 必要性 备注
beforeTagids data
afterTagids data
fids data 目标用户UID 必要 每个ID之间用","（%2C）间隔
csrf data cookies中的bili_jct 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-111：csrf校验失败
-101：账号未登录
-400：请求错误
22104：无权限
22105：未关注
message str 错误信息 默认为0
ttl num 1 作用尚不明确

示例：

把关注用户UID=3211734 69和UID=327086920同时从ID为207542的分组移动到ID为231305的分组中

curl -b SESSDATA=xxx -d "beforeTagids=207542&afterTagids=231305&fids=3211734 69%2C327086920&csrf=xxx" "http://api.bilibili.com/x/relation/tags/moveUsers"

{
    "code":0,
    "message":"0",
    "ttl":1
}