Skip to content

Latest commit

 

History

History
295 lines (244 loc) · 9.3 KB

tags.md

File metadata and controls

295 lines (244 loc) · 9.3 KB
Raw

视频TAG

获取视频TAG信息

http://api.bilibili.com/x/tag/archive/tags

请求方式：GET

认证方式：Cookie（SESSDATA）

url参数：

参数名 类型 内容 必要性 备注
aid num 视频avID 必要（可选） avID与bvID任选一个
bvid str 视频bvID 必要（可选） avID与bvID任选一个

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
message str 错误信息 默认为0
ttl num 1
data array TAG列表 无TAG为空

data数组：

项 类型 内容 备注
0 obj 第1个TAG
n obj 第（n+1）个TAG
…… obj …… ……

data数组中的对象：

字段 类型 内容 备注
tag_id num TAGID
tag_name str TAG名称
cover str TAG图片url
head_cover str TAG页面头图url
content str TAG介绍
short_content str TAG简介
type num ？？？
state num 0
ctime num 创建时间 时间戳
count obj 状态数
is_atten num 是否关注 0：未关注
1：已关注
需要登录(Cookie)
未登录为0
likes num 0 作用尚不明确
hates num 0 作用尚不明确
attribute num 0 作用尚不明确
liked num 是否已经点赞 0：未点赞
1：已点赞
需要登录(Cookie)
未登录为0
hated num 是否已经点踩 0：未点踩
1：已点踩
需要登录(Cookie)
未登录为0

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

字段 类型 内容 备注
view num 0 作用尚不明确
use num 视频添加TAG数
atten num TAG关注

示例：

查询视频av89772773/BV1M741177Kg的TAG

avID方式：

curl -G 'http://api.bilibili.com/x/tag/archive/tags'\
--data-urlencode 'aid=89772773'\
-b 'SESSDATA=xxx'

bvID方式：

curl -G 'http://api.bilibili.com/x/tag/archive/tags'\
--data-urlencode 'bvid=BV1M741177Kg'\
-b 'SESSDATA=xxx'
{
	"code": 0,
	"message": "0",
	"ttl": 1,
	"data": [{
		"tag_id": 12620189,
		"tag_name": "异度侵入",
		"cover": "",
		"head_cover": "",
		"content": "",
		"short_content": "",
		"type": 1,
		"state": 0,
		"ctime": 1576235749,
		"count": {
			"view": 0,
			"use": 6392,
			"atten": 8938
		},
		"is_atten": 1,
		"likes": 1,
		"hates": 0,
		"attribute": 0,
		"liked": 0,
		"hated": 0
	}, {
		"tag_id": 7520816,
		"tag_name": "bilibili新星计划",
		"cover": "",
		"head_cover": "",
		"content": "",
		"short_content": "",
		"type": 4,
		"state": 0,
		"ctime": 1529717850,
		"count": {
			"view": 0,
			"use": 1967314,
			"atten": 65082
		},
		"is_atten": 0,
		"likes": 0,
		"hates": 0,
		"attribute": 0,
		"liked": 0,
		"hated": 0
	}, {
		"tag_id": 707,
		"tag_name": "ED",
		"cover": "",
		"head_cover": "",
		"content": "",
		"short_content": "",
		"type": 3,
		"state": 0,
		"ctime": 1436866637,
		"count": {
			"view": 0,
			"use": 62646,
			"atten": 75642
		},
		"is_atten": 1,
		"likes": 0,
		"hates": 0,
		"attribute": 0,
		"liked": 0,
		"hated": 0
	}, {
		"tag_id": 1394,
		"tag_name": "动漫",
		"cover": "http://i0.hdslb.com/bfs/tag/d08c5fe17ceb793e7ce95d9c67392743b33b46d0.jpg",
		"head_cover": "",
		"content": "      “动漫”是动画和漫画的合称与缩写。在其他语言相当少用。随着现代传媒技术的发展，动画（animation或anime）和漫画（comics，manga；特别是故事性漫画）之间联系日趋紧密，两者常被合而为“动漫”。\n　   由于漫画本身的发展形成了现代故事漫画的表现形式，将影视艺术融入漫画之中，使得漫画与动画更容易结合，影视艺术独特的地方在于它能通过镜头的推拉摇移和片段剪辑的蒙太奇技巧来表达想法和感受。漫画正是吸收了影视艺术的这两个特点。当讲述的故事越发复杂、人物越发丰富的时候，传统单线式叙事的方法就越行不通，蒙太奇的介入就成为一种需要了；当漫画家在传统表现手段中无法找到更合适的抒发感情的方法的时候，当读者需要作品有更强的冲击力和表现力的时候，各种镜头的灵活运用就成为一种必需了。一部现代故事漫画往往集远、中、近、特四种镜头于一身，漫画家往往能熟练地运用镜头的移动和各种蒙太奇剪接，对故事特定部分的情绪和氛围进行渲染。这就是现代故事漫画容易和动画结合的一个原因，因为它天生就像动画的分镜头剧本，读者在看漫画时如同在看一部电影。正是有着这样的相似性所以如今将动画和漫画合称为“动漫”。",
		"short_content": "",
		"type": 3,
		"state": 0,
		"ctime": 1436866637,
		"count": {
			"view": 0,
			"use": 1134143,
			"atten": 113030
		},
		"is_atten": 0,
		"likes": 0,
		"hates": 0,
		"attribute": 0,
		"liked": 0,
		"hated": 0
	}, {
		"tag_id": 13289329,
		"tag_name": "异度侵入ed原图",
		"cover": "",
		"head_cover": "",
		"content": "",
		"short_content": "",
		"type": 1,
		"state": 0,
		"ctime": 1581948411,
		"count": {
			"view": 0,
			"use": 3,
			"atten": 0
		},
		"is_atten": 0,
		"likes": 0,
		"hates": 0,
		"attribute": 0,
		"liked": 0,
		"hated": 0
	}]
}

点赞&取消点赞视频TAG

http://api.bilibili.com/x/tag/archive/like2

请求方式：POST

认证方式：Cookie（SESSDATA）

重复请求为取消

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

参数名 类型 内容 必要性 备注
aid num 视频avID 必要
tag_id num TAGID 必要
csrf str CSRF Token（位于cookie） 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
message str 错误信息 默认为0
ttl num 1

示例：

为视频av89772773的TAG12620189点赞

curl 'http://api.bilibili.com/x/tag/archive/like2'\
--data-urlencode 'aid=89772773'\
--data-urlencode 'tag_id=12620189'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
{
    "code": 0,
    "message": "0",
    "ttl": 1
}

点踩&取消点踩视频TAG

http://api.bilibili.com/x/tag/archive/hate2

请求方式：POST

认证方式：Cookie（SESSDATA）

重复访问为取消

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

参数名 类型 内容 必要性 备注
aid num 视频avID 必要
tag_id num TAGID 必要
csrf str CSRF Token（位于cookie） 必要

json回复：

根对象：

字段 类型 内容 备注
code num 返回值 0：成功
-400：请求错误
message str 错误信息 默认为0
ttl num 1

示例：

为视频av89772773的TAG7520816点踩

curl 'http://pi.bilibili.com/x/tag/archive/hate2'\
--data-urlencode 'aid=89772773'\
--data-urlencode 'tag_id=7520816'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
{
    "code": 0,
    "message": "0",
    "ttl": 1
}