From b25a968e1980a56fee5027424784b53036e1bd4b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=A4=BE=E4=BC=9A=E6=98=93=E5=A7=90QwQ?= <45892418+SocialSisterYi@users.noreply.github.com> Date: Sat, 25 Apr 2020 18:15:21 +0800 Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E8=A7=86=E9=A2=91TAG?= =?UTF-8?q?=E7=9B=B8=E5=85=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 28 ++++-- video/tags.md | 273 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 291 insertions(+), 10 deletions(-) create mode 100644 video/tags.md diff --git a/README.md b/README.md index ee59072..4f0e600 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,7 @@ 计划整理分类&目录：（√代表已完成，x代表正在施工...） - cookie -- [图片格式化](other/picture.md) +- [图片格式化](other/picture.md)√ - [登录](login) - [二维码登录](login/QR.md)√ - 密码&短信登录 @@ -36,7 +36,7 @@ - [状态数](video/status_number.md)√ - [快照](video/snapshot.md)√ - [点赞&投币&收藏](video/like_coin_fav.md)√ - - TAG + - [TAG](video/tags.md)x - [视频推荐](video/recommend.md)√ - 播放&下载地址 - 互动视频 @@ -131,6 +131,20 @@ B站专栏同步推出[《B站api研究记》](https://www.bilibili.com/read/rea **相关项目**： +库及文档： + +https://github.com/jingyuexing/bilibiliAPI + +https://github.com/fython/BilibiliAPIDocs + +https://github.com/czp3009/bilibili-api + +https://github.com/Vespa314/bilibili-api + +https://github.com/Hsury/Bilibili-Toolkit + +成品： + https://github.com/zyzsdy/biliroku https://github.com/bilibili-helper/bilibili-helper-o @@ -143,15 +157,9 @@ https://github.com/Hsury/BiliDrive https://github.com/Tsuk1ko/bilibili-live-chat -https://github.com/SocialSisterYi/bv2av_convert - -https://github.com/fython/BilibiliAPIDocs - -https://github.com/czp3009/bilibili-api - -https://github.com/Vespa314/bilibili-api +其他： https://github.com/Hsury/Geetest3-Crack -https://github.com/Hsury/Bilibili-Toolkit +https://github.com/SocialSisterYi/bv2av_convert diff --git a/video/tags.md b/video/tags.md new file mode 100644 index 0000000..609dc7b --- /dev/null +++ b/video/tags.md @@ -0,0 +1,273 @@ +# 视频TAG + +## 获取视频TAG信息 + +> http://https://api.bilibili.com/x/tag/archive/tags + +*方式：GET* + +**参数：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | -------- | ------ | ------------------ | +| aid | url | 视频avID | 非必要 | avID与bvID任选一个 | +| bvid | url | 视频bvID | 非必要 | avID与bvID任选一个 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ------ | -------- | ---------------------------- | +| code | num | 返回值 | 0：成功
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | +| data | arrary | 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：已关注
需要登录(SESSDATA)
未登录为0 | +| likes | num | 0 | 作用尚不明确 | +| hates | num | 0 | 作用尚不明确 | +| attribute | num | 0 | 作用尚不明确 | +| liked | num | 是否已经点赞 | 0：未点赞
1：已点赞
需要登录(SESSDATA)
未登录为0 | +| hated | num | 是否已经点踩 | 0：未点踩
1：已点踩
需要登录(SESSDATA)
未登录为0 | + +`data`数组中的对象中的`count`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | ------------- | ------------ | +| view | num | 0 | 作用尚不明确 | +| use | num | 视频添加TAG数 | | +| atten | num | TAG关注 | | + +**示例：** + +查询视频`av89772773`/`BV1M741177Kg`的TAG + +http://api.bilibili.com/x/tag/archive/tags?aid=89772773 + +同http://api.bilibili.com/x/tag/archive/tags?bvid=BV1M741177Kg + +```json +{ + "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（暂不支持bvID） + +> http://api.bilibili.com/x/tag/archive/like2 + +*方式：POST* + +需要登录(SESSDATA) + +重复访问为取消 + +**参数（ application/x-www-form-urlencoded ）：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ------------------- | ------ | ---- | +| aid | data | 视频avID | 必要 | | +| tag_id | data | TAGID | 必要 | | +| csrf | data | cookies中的bili_jct | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ---------------------------- | +| code | num | 返回值 | 0：成功
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | + +**示例：** + +为视频`av89772773`的TAG`TAGID=12620189`点赞 + +curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=89772773&tag_id=12620189" "http://api.bilibili.com/x/tag/archive/like2" + +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` + + + +## 点踩&取消点踩视频TAG（暂不支持bvID） + +> http://api.bilibili.com/x/tag/archive/hate2 + +*方式：POST* + +需要登录(SESSDATA) + +重复访问为取消 + +**参数（ application/x-www-form-urlencoded ）：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ------------------- | ------ | ---- | +| aid | data | 视频avID | 必要 | | +| tag_id | data | TAGID | 必要 | | +| csrf | data | cookies中的bili_jct | 必要 | | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ---------------------------- | +| code | num | 返回值 | 0：成功
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | 作用尚不明确 | + +**示例：** + +为视频`av89772773`的TAG`TAGID=7520816`点踩 + +curl -b "SESSDATA=xxx" -d "csrf=xxx&aid=89772773&tag_id=7520816" "http://api.bilibili.com/x/tag/archive/hate2" + +```json +{ + "code": 0, + "message": "0", + "ttl": 1 +} +``` +