From 3c69d4d9521a216e9a13cfee1f169697785619e5 Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Wed, 26 Jun 2024 23:18:33 +0800 Subject: [PATCH 01/11] feat: add get users info --- docs/user/info.md | 296 ++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 276 insertions(+), 20 deletions(-) diff --git a/docs/user/info.md b/docs/user/info.md index ff69b85..496874a 100644 --- a/docs/user/info.md +++ b/docs/user/info.md @@ -933,18 +933,16 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \ ## 多用户详细信息 -> https://api.vc.bilibili.com/account/v1/user/cards +> https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards *请求方式：GET* -认证方式：Cookie(SESSDATA) - -本接口较其他接口相比，只会返回非常有限的信息，但可以同时获取较多的用户信息（据测试可以同时获取 40000 多个用户的信息） +可以同时获取较多的用户信息（据测试可以一次性获取 2000 多个用户的信息；若获取更多用户信息可能会返回 -504 `服务调用超时`） **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | ----------------- | ------ | --------------------------------- | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ----------------- | ------ | ------------------- | | uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔 | **json回复：** @@ -954,8 +952,271 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ----- | -------- | --------------------------- | | code | num | 返回值 | 0：成功
-400：请求错误 | -| msg | str | 错误信息 | 默认为空 | -| message | str | 错误信息 | 默认为空 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | 用户信息随机排序 | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ---- | ----------------------- | ---- | +| {用户mid} | obj | 该mid对应的用户信息 | | +| …… | obj | …… | …… | + +`data`中的`{用户mid}`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------ | ---- | ------------------- | -------------------- | +| face | str | 头像链接 | | +| face_nft | num | 是否为 NFT 头像 | 0：不是 NFT 头像
1：是 NFT 头像 | +| face_nft_new | num | 是否为新版 NFT 头像 | | +| mid | str | mid | | +| name | str | 昵称 | | +| name_render | 有效时：obj
无效时：null | 昵称渲染信息 | | +| nameplate | 有效时：obj
无效时：null | 勋章信息 | 基本同「[用户空间详细信息](#用户空间详细信息)」中的 `data.nameplate` 对象 | +| official | obj | 认证信息 | 基本同「[用户空间详细信息](#用户空间详细信息)」中的 `data.official` 对象 | +| pendant | 有效时：obj
无效时：null| 头像框信息 | 基本同「[用户空间详细信息](#用户空间详细信息)」中的 `data.pendant` 对象，其中有些类型为 `num` 的字段在本接口中类型为 `str` | +| vip | obj | 会员信息 | 基本同「[用户空间详细信息](#用户空间详细信息)」中的 `data.vip` 对象，其中有些类型为 `num` 的字段在本接口中类型为 `str` | + +`{用户mid}`中的`name_render`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------------- | ---- | --------------------------- | ---------------- | +| colors_info | obj | 昵称颜色信息（？） | **作用尚不明确** | +| render_scheme | str | `"Default"` 或 `"Colorful"` | **作用尚不明确** | + +`name_render`中的`colors_info`对象： + +| 字段 | 类型 | 内容 | 备注 | +| --------- | ----- | -------------- | ---------------- | +| color | array | 昵称颜色（？） | **作用尚不明确** | +| color_ids | array | `["6"]` | **作用尚不明确** | + +`color`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---- | +| 0 | obj | 颜色1 | | +| n | obj | 颜色(n+1) | | +| …… | obj | …… | …… | + +`color`数组中的对象： + +| 字段 | 类型 | 内容 | 备注 | +| ----------- | ---- | ---------------- | ---------------- | +| color_day | str | 浅色模式昵称颜色 | HEX颜色代码 | +| color_night | str | 深色模式昵称颜色 | HEX颜色代码 | + +**示例：** + +查询用户`uids=1,2,3`的详细信息 + +```shell +curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \ +--data-urlencode 'uids=1,2,3' \ +``` + +
+查看响应示例： + +```json +{ + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "1": { + "face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif", + "face_nft": 0, + "face_nft_new": 0, + "mid": "1", + "name": "bishi", + "name_render": { + "colors_info": { "color": [], "color_ids": [ "6" ] }, + "render_scheme": "Default" + }, + "nameplate": null, + "official": { "desc": "", "role": 0, "title": "", "type": -1 }, + "pendant": null, + "vip": { + "avatar_icon": { + "icon_resource": { + "type": "ICON_RES_TYPE_IMAGE", + "url": "https://i0.hdslb.com/bfs/bangumi/kt/aba51485c0d02940c89aeefcf6680510d9858472.png" + }, + "icon_type": "ICON_TYPE_VIP_ACTIVITY" + }, + "avatar_subscript": 1, + "avatar_subscript_url": "", + "due_date": "1883059200000", + "label": { + "bg_color": "#FB7299", + "bg_style": 1, + "border_color": "", + "img_label_uri_hans": "", + "img_label_uri_hans_static": "https://i0.hdslb.com/bfs/bangumi/kt/fb0a74b14d6a4e119ae301ba2693febeda051030.png", + "img_label_uri_hant": "", + "img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/sGu57N6pgK.png", + "label_theme": "ten_annual_vip", + "path": "", + "text": "十年大会员", + "text_color": "#FFFFFF", + "use_img_label": true + }, + "nickname_color": "#FB7299", + "role": "7", + "status": 1, + "theme_type": 0, + "tv_due_date": "1633622400", + "tv_vip_pay_type": 0, + "tv_vip_status": 0, + "type": 2, + "vip_pay_type": 1 + } + }, + "2": { + "face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg", + "face_nft": 0, + "face_nft_new": 0, + "mid": "2", + "name": "碧诗", + "name_render": { + "colors_info": { "color": [], "color_ids": [ "6" ] }, + "render_scheme": "Default" + }, + "nameplate": { + "condition": "所有自制视频总播放数>=10万", + "image": "https://i1.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png", + "image_small": "https://i2.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png", + "level": "普通勋章", + "name": "见习偶像", + "nid": 10 + }, + "official": { "desc": "", "role": 2, "title": "bilibili创始人（站长）", "type": 0 }, + "pendant": { + "expire": "0", + "image": "https://i2.hdslb.com/bfs/garb/item/488870931b1bba66da36d22848f0720480d3d79a.png", + "image_enhance": "https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp", + "image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png", + "n_pid": "32257", + "name": "EveOneCat2", + "pid": 32257 + }, + "vip": { + "avatar_icon": { + "icon_resource": { + "type": "ICON_RES_TYPE_IMAGE", + "url": "https://i0.hdslb.com/bfs/bangumi/kt/aba51485c0d02940c89aeefcf6680510d9858472.png" + }, + "icon_type": "ICON_TYPE_VIP_ACTIVITY" + }, + "avatar_subscript": 1, + "avatar_subscript_url": "", + "due_date": "3968841600000", + "label": { + "bg_color": "#FB7299", + "bg_style": 1, + "border_color": "", + "img_label_uri_hans": "", + "img_label_uri_hans_static": "https://i0.hdslb.com/bfs/bangumi/kt/53845a8ab8b226131c5d89b198d4b61de91d0aa2.png", + "img_label_uri_hant": "", + "img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/8u7iRTPE7N.png", + "label_theme": "ten_annual_vip", + "path": "", + "text": "十年大会员", + "text_color": "#FFFFFF", + "use_img_label": true + }, + "nickname_color": "#FB7299", + "role": "7", + "status": 1, + "theme_type": 0, + "tv_due_date": "2003500800", + "tv_vip_pay_type": 1, + "tv_vip_status": 1, + "type": 2, + "vip_pay_type": 0 + } + }, + "3": { + "face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg", + "face_nft": 0, + "face_nft_new": 0, + "mid": "3", + "name": "囧囧倉", + "name_render": { + "colors_info": { + "color": [ + { "color_day": "#CB7919", "color_night": "#E2963C" }, + { "color_day": "#E6A75B", "color_night": "#E6A75B" }, + { "color_day": "#E9BD67", "color_night": "#F8CE7E" } + ], + "color_ids": [ "6" ] + }, + "render_scheme": "Colorful" + }, + "nameplate": null, + "official": { "desc": "", "role": 0, "title": "", "type": -1 }, + "pendant": null, + "vip": { + "avatar_icon": null, + "avatar_subscript": 0, + "avatar_subscript_url": "", + "due_date": "0", + "label": { + "bg_color": "", + "bg_style": 0, + "border_color": "", + "img_label_uri_hans": "", + "img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/d7b702ef65a976b20ed854cbd04cb9e27341bb79.png", + "img_label_uri_hant": "", + "img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/KJunwh19T5.png", + "label_theme": "", + "path": "", + "text": "", + "text_color": "", + "use_img_label": true + }, + "nickname_color": "", + "role": "0", + "status": 0, + "theme_type": 0, + "tv_due_date": "0", + "tv_vip_pay_type": 0, + "tv_vip_status": 0, + "type": 0, + "vip_pay_type": 0 + } + } + } +} +``` + +
+ +## 多用户详细信息2 + +> https://api.vc.bilibili.com/account/v1/user/cards + +*请求方式：GET* + +本接口较其他接口相比，只会返回非常有限的信息，但可以同时获取较多的用户信息（据测试可以一次性获取 40000 多个用户的信息） + +**url参数：** + +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ----------------- | ------ | ------------------- | +| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔 | + +**json回复：** + +根对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | -------- | --------------------------- | +| code | num | 返回值 | 0：成功
-400：请求错误 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | | data | array | 信息本体 | 用户信息随机排序 | `data`数组： @@ -972,7 +1233,6 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \ | ------- | ---- | ------------ | -------------------- | | mid | num | mid | | | name | str | 昵称 | | -| sex | str | 性别 | 男/女/保密 | | face | str | 头像链接 | | | sign | str | 签名 | | | rank | num | 用户权限等级 | | @@ -986,7 +1246,6 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \ ```shell curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \ --data-urlencode 'uids=1,2,3' \ --b 'SESSDATA=xxx' ```
@@ -995,34 +1254,31 @@ curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \ ```json { "code": 0, - "msg": "", "message": "", + "ttl": 1, "data": [{ "mid": 1, "name": "bishi", - "sex": "男", - "face": "https://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif", + "face": "http://i1.hdslb.com/bfs/face/34c5b30a990c7ce4a809626d8153fa7895ec7b63.gif", "sign": "", "rank": 10000, - "level": 4, + "level": 6, "silence": 0 }, { "mid": 2, "name": "碧诗", - "sex": "男", - "face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg", - "sign": "https://kami.im 直男过气网红 # av362830 “We Are Star Dust”", + "face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg", + "sign": "https://kami.im 直男过气网红 # We Are Star Dust", "rank": 20000, "level": 6, "silence": 0 }, { "mid": 3, "name": "囧囧倉", - "sex": "男", - "face": "https://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg", + "face": "http://i0.hdslb.com/bfs/face/d4de6a84557eea8f18510a3f61115d96832aa071.jpg", "sign": "富强、民主、文明、和谐、自由、平等、公正、法治、爱国、敬业、诚信、友善。", "rank": 10000, - "level": 5, + "level": 6, "silence": 0 }] } From a201a3c9cabda923bfcf706a9b17827ed881142b Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Wed, 26 Jun 2024 23:30:01 +0800 Subject: [PATCH 02/11] =?UTF-8?q?=E5=B0=86=20#983=20=E4=B8=AD=E5=AF=B9?= =?UTF-8?q?=E6=AD=A4=E6=96=87=E4=BB=B6=E7=9A=84=E6=9B=B4=E6=94=B9=E5=90=88?= =?UTF-8?q?=E5=B9=B6=E5=88=B0=E6=AD=A4=20PR=20=E4=B8=AD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/user/relation.md | 32 +++++++++++++++----------------- 1 file changed, 15 insertions(+), 17 deletions(-) diff --git a/docs/user/relation.md b/docs/user/relation.md index 9695adc..4c4f1ac 100644 --- a/docs/user/relation.md +++ b/docs/user/relation.md @@ -11,7 +11,7 @@ | 字段 | 类型 | 内容 | 备注 | | --------------- | ------------------------------------------- | -------------------------- | ------------------------------------------------------------ | | mid | num | 用户 mid | | -| attribute | num | 对方对于**自己**的关系属性 | 0：未关注
1：悄悄关注（现已下线）
2：已关注
6：已互粉
128：已拉黑 | +| attribute | num | 对方对于**自己**的关系属性 | 0：未关注
~~1：悄悄关注（现已下线）~~
2：已关注
6：已互粉
128：已拉黑 | | mtime | num | 对方关注目标用户时间 | 秒级时间戳
互关后刷新 | | tag | 默认分组：null
存在至少一个分组：array | 目标用户将对方分组到的 id | | | special | num | 目标用户特别关注对方标识 | 0：否
1：是 | @@ -97,7 +97,7 @@ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ----------------------------------------------------- | -| code | num | 返回值 | 0：成功
-101：账号未登录
-352：请求被拦截
-400：请求错误
22007：访问超过 5 页 | +| code | num | 返回值 | 0：成功
-101：账号未登录
-352：请求被拦截
-400：请求错误
22118：由于该用户隐私设置，粉丝列表不可见 | | message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | | data | obj | 信息本体 | | @@ -368,7 +368,7 @@ curl -G 'https://api.bilibili.com/x/relation/followings' \ | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ----------- | --------------------------------------------- | -| 0 | obj | 关注 1 | 与 [关系列表对象](#关系列表对象) 数据结构不同 | +| 0 | obj | 关注 1 | 与 [关系列表对象](#关系列表对象) 数据结构**不同** | | n | obj | 关注（n+1） | 按照添加顺序排列 | | …… | obj | …… | …… | @@ -501,9 +501,7 @@ curl -G 'https://app.biliapi.net/x/v2/relation/followings' \
-## 查询用户关注明细3 - - +### 查询用户关注明细3 > https://line3-h5-mobile-api.biligame.com/game/center/h5/user/relationship/following_list @@ -1289,15 +1287,15 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \ 操作代码`act`： -| 代码 | 含义 | -| ---- | ------------ | -| 1 | 关注 | -| 2 | 取关 | -| 3 | 悄悄关注 | -| 4 | 取消悄悄关注 | -| 5 | 拉黑 | -| 6 | 取消拉黑 | -| 7 | 踢出粉丝 | +| 代码 | 含义 | 备注 | +| ---- | ------------ | ------------------------------------------------ | +| 1 | 关注 | 无法对已注销或不存在的用户进行此操作 | +| 2 | 取关 | | +| 3 | 悄悄关注 | 现已下线，使用本操作代码请求接口会提示“请求错误” | +| 4 | 取消悄悄关注 | | +| 5 | 拉黑 | 无法对已注销或不存在的用户进行此操作 | +| 6 | 取消拉黑 | | +| 7 | 踢出粉丝 | | **json回复：** @@ -1305,7 +1303,7 @@ curl -G 'https://api.bilibili.com/x/relation/blacks' \ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
22001：不能对自己进行此操作
22003：用户位于黑名单 | +| code | num | 返回值 | 0：成功
-101：账号未登录
-102：账号被封停
-111：csrf校验失败
-400：请求错误
22001：不能对自己进行此操作
22002：因对方隐私设置，你还不能关注
22003：关注失败，请将该用户移除黑名单之后再试
22013：账号已注销，无法完成操作
22014：已经关注用户，无法重复关注
22120：重复加入黑名单
40061：用户不存在 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | | @@ -1684,7 +1682,7 @@ curl -G 'https://api.bilibili.com/x/relation/relations' \ | 项 | 类型 | 内容 | 备注 | | ---- | ---- | ----------- | ---- | -| 1 | obj | 分组 1 | | +| 0 | obj | 分组 1 | | | n | obj | 分组（n+1） | | | …… | num | …… | …… | From 4fb88fbe9ca4d73aa5acb08f25a8d7ebc2a78508 Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Wed, 26 Jun 2024 23:38:17 +0800 Subject: [PATCH 03/11] fix: typo --- docs/user/info.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/user/info.md b/docs/user/info.md index 496874a..a6c841a 100644 --- a/docs/user/info.md +++ b/docs/user/info.md @@ -1013,7 +1013,7 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \ ```shell curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \ ---data-urlencode 'uids=1,2,3' \ +--data-urlencode 'uids=1,2,3' ```
@@ -1245,7 +1245,7 @@ curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \ ```shell curl -G 'https://api.vc.bilibili.com/account/v1/user/cards' \ ---data-urlencode 'uids=1,2,3' \ +--data-urlencode 'uids=1,2,3' ```
From 0a8bac8e2b7b13e86111f549e87d50a9017f35c1 Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Sat, 6 Jul 2024 22:36:25 +0800 Subject: [PATCH 04/11] Update info.md --- docs/user/info.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/user/info.md b/docs/user/info.md index a6c841a..d7f5fbf 100644 --- a/docs/user/info.md +++ b/docs/user/info.md @@ -1200,13 +1200,13 @@ curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \ *请求方式：GET* -本接口较其他接口相比，只会返回非常有限的信息，但可以同时获取较多的用户信息（据测试可以一次性获取 40000 多个用户的信息） +本接口较其他接口相比，只会返回非常有限的信息 **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | ----------------- | ------ | ------------------- | -| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ----------------- | ------ | --------------------------------------------------------------------- | +| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔，最多50个成员，若超过此限制则返回的`data`数组为空 | **json回复：** From a7c7788eaaff36a6f4b59d07d8a72900390d7ac2 Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Sat, 6 Jul 2024 22:59:38 +0800 Subject: [PATCH 05/11] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20danmaku=5Fview=5Fpro?= =?UTF-8?q?to.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/danmaku/danmaku_view_proto.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/danmaku/danmaku_view_proto.md b/docs/danmaku/danmaku_view_proto.md index 34e669c..4c761e3 100644 --- a/docs/danmaku/danmaku_view_proto.md +++ b/docs/danmaku/danmaku_view_proto.md @@ -95,7 +95,7 @@ | posX | num | X坐标 | 区间：[118-549] | | posY | num | Y坐标 | 区间：[82-293] | | icon | str | 按钮图片url | 不应该是关注按钮吗，但这个是圆形的 | -| type | num | 关注按钮类型 | 0：仅关注
1：仅三联
2：关注+三联 | +| type | num | 关注按钮类型 | 0：仅关注
1：仅三连
2：关注+三连 | 消息`dmSetting`： From b16381e0ed1d6337d80801b719de1f56b917a0e1 Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Sat, 6 Jul 2024 23:00:07 +0800 Subject: [PATCH 06/11] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20action.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/album/action.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/album/action.md b/docs/album/action.md index f24342e..b209dad 100644 --- a/docs/album/action.md +++ b/docs/album/action.md @@ -93,7 +93,7 @@ curl 'https://api.vc.bilibili.com/link_draw/v2/Vote/operate' \ 收藏相簿`id=99184721` ```shell -curl 'https:///api.vc.bilibili.com/user_plus/v1/Fav/add' \ +curl 'https://api.vc.bilibili.com/user_plus/v1/Fav/add' \ --data-urlencode 'fav_id=99184721' \ --data-urlencode 'biz_type=2' \ --data-urlencode 'csrf_token=xxx' \ From 3390585af889b5a0abd63016e65f2199f6d72a12 Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Sat, 6 Jul 2024 23:06:36 +0800 Subject: [PATCH 07/11] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20info.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/video/info.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/video/info.md b/docs/video/info.md index 7d0bfbd..8fc4101 100644 --- a/docs/video/info.md +++ b/docs/video/info.md @@ -775,7 +775,7 @@ https://i1.hdslb.com/bfs/archive/ea0dd34bf41e23a68175680a00e3358cd249105f.jpg `Related`数组中的对象： -基本同「[获取视频详细信息(web端)](#获取视频详细信息(web端))」中的data对象 +基本同「[获取视频详细信息(web端)](#获取视频详细信息(web端))」中的data对象，已知没有分P信息 `data`中的`hot_share`对象： From cde5cad725853784d065820d4cc235a9d38e117d Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Sat, 6 Jul 2024 23:06:58 +0800 Subject: [PATCH 08/11] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20recommend.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/video/recommend.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/video/recommend.md b/docs/video/recommend.md index 10b5e18..ea7e092 100644 --- a/docs/video/recommend.md +++ b/docs/video/recommend.md @@ -42,7 +42,7 @@ `data`数组中的对象： -基本同「[获取视频详细信息（web端）](info.md#获取视频详细信息（web端）)」中的data对象 +基本同「[获取视频详细信息（web端）](info.md#获取视频详细信息（web端）)」中的data对象，已知没有分P信息 **示例：** From f8b728725510542eb05472dad1f0c0c32ee3c981 Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Sat, 6 Jul 2024 23:07:36 +0800 Subject: [PATCH 09/11] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20readme.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/comment/readme.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/comment/readme.md b/docs/comment/readme.md index 469b19e..c74c42b 100644 --- a/docs/comment/readme.md +++ b/docs/comment/readme.md @@ -132,7 +132,7 @@ | 字段 | 类型 | 内容 | 备注 | | ---- | ---- | -------- | ---------------------------------------- | -| type | num | 是否认证 | -1：无
0：个人认证
1：机构认证 | +| type | num | 认证类型 | -1：无
0：个人认证
1：机构认证 | | desc | str | 认证信息 | 无为空 | `member`中的`vip`对象： From 478feea1b24b4ac252c8f7cb4ac335c15e4504eb Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Sat, 6 Jul 2024 23:33:37 +0800 Subject: [PATCH 10/11] =?UTF-8?q?feat:=20=E8=A7=84=E8=8C=83=E5=8C=96?= =?UTF-8?q?=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/dynamic/action.md | 110 +++++++---------------- docs/dynamic/atlist.md | 200 +++++++++++++++++++++++++++++------------ docs/user/info.md | 4 +- 3 files changed, 177 insertions(+), 137 deletions(-) diff --git a/docs/dynamic/action.md b/docs/dynamic/action.md index 5999596..45b72cc 100644 --- a/docs/dynamic/action.md +++ b/docs/dynamic/action.md @@ -10,95 +10,53 @@ **正文参数（multipart/form-data）：** -| 参数名 | 类型 | 内容 | -| ---------- | ---- | ------ | -| dynamic_id | num | 动态id | -| csrf_token | str | csrf | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ---------- | ---- | ------ | ------ | ---- | +| dynamic_id | num | 动态id | 必要 | | +| csrf_token | str | csrf | 必要 | | +| csrf | str | csrf | 必要 | | **json回复：** 根对象： -| 字段 | 类型 | 内容 | -| ------- | ---- | ----------------- | -| code | num | 0:成功 | -| | | 500404:已经删除过 | -| | | 500406:不是自己的 | -| msg | str | 错误信息 | -| message | str | 和msg一样 | -| data | obj | 未知 | +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | --------------------------------------------------------------------------------------- | +| code | num | 返回值 | 0：成功
-101：账号未登录
500404：已经删除过该动态
500406：动态不是自己的 | +| msg | str | 错误信息 | 成功时为空文本 | +| message | str | 错误信息 | 同`msg` | +| data | obj | 数据本体 | | + +`data`对象： + +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | ---- | ---------------- | +| \_gt\_ | num | 0 | **作用尚不明确** | + +**示例：** + +删除动态`dynamic_id=588320531406678918` + +```shell +curl 'https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/rm_dynamic' \ +--data-urlencode 'dynamic_id=588320531406678918' \ +--data-urlencode 'csrf_token=xxx' \ +--data-urlencode 'csrf=xxx' \ +-b 'SESSDATA=xxx' +```
-查看示例 - - -```bash -curl 'https://api.vc.bilibili.com/dynamic_svr/v1/dynamic_svr/rm_dynamic' \ - -X POST \ - -H 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:93.0) Gecko/20100101 Firefox/93.0' \ - -H 'Referer: https://t.bilibili.com/' \ - -H 'Cookie: SESSDATA=********; bili_jct=de2731532b4ab96bc8536da948932668;' \ - --data-raw 'dynamic_id=588320531406678918&csrf_token=de2731532b4ab96bc8536da948932668&csrf=de2731532b4ab96bc8536da948932668' -``` +查看响应示例： ```json { - "code":0, - "msg":"", - "message":"", + "code": 0, + "msg": "", + "message": "", "data": { - "_gt_":0 + "_gt_": 0 } } ```
- -## 删除草稿 - -> https://api.vc.bilibili.com/dynamic_draft/v1/dynamic_draft/rm_draft - -*请求方式：POST* - -认证方式：Cookie（SESSDATA） - -**正文参数（application/x-www-form-urlencoded）：** - -| 参数名 | 类型 | 内容 | -| ---------- | ---- | -------------- | -| draft_id | num | 定时发送草稿id | -| csrf_token | str | csrf | - -**json回复：** - -根对象： - -| 字段 | 类型 | 内容 | -| ------- | ---- | ---------------------------- | -| code | num | 0:成功
4120015: 系统异常 | -| message | str | 错误信息 | -| ttl | num | 1 | -| data | obj | 空对象 | - -
-查看示例 - - -```bash -curl -X POST 'https://api.vc.bilibili.com/dynamic_draft/v1/dynamic_draft/rm_draft' \ ---data-urlencode 'draft_id=755409289278914611' \ ---data-urlencode 'csrf=xxxx' --b 'SESSDATA=xxxx;' \ -``` - -```json -{ - "code": 0, - "message": "0", - "ttl": 1, - "data": {} -} -``` - -
- diff --git a/docs/dynamic/atlist.md b/docs/dynamic/atlist.md index 09a0adf..9607a54 100644 --- a/docs/dynamic/atlist.md +++ b/docs/dynamic/atlist.md @@ -1,6 +1,6 @@ -# 根据关键字搜索用户(at别人时的填充列表) +# 根据关键字搜索用户 (at别人时的填充列表) -**注意关键字不一定顺序匹配,如最后示例** +**注意关键字不一定顺序匹配，如最后示例** > https://api.vc.bilibili.com/dynamic_mix/v1/dynamic_mix/at_search @@ -8,60 +8,79 @@ 认证方式：Cookie（SESSDATA） -**正文参数（multipart/form-data）：** +**url参数：** -| 参数名 | 类型 | 内容 | -| --- | --- | --- | -| uid | num | 自己的uid | -| keyword | str | 搜索关键字 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------- | ---- | ---------- | ------ | ---- | +| uid | num | 自己的mid | 必要 | | +| keyword | str | 搜索关键字 | 必要 | | **json回复：** 根对象： -| 字段 | 类型 | 内容 | -| --- | --- | --- | -| code | num | 0成功 | -| msg | str | 成功为空文本 | -| message | str | 同msg | -| data | obj | 数据本体 | +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | --------------------------------------------------------------------------------------------- | +| code | num | 返回值 | 0：成功
1024：系统开小差了
2001：关键字不合法
7600001：参数出错了，请输入正确参数
7600008：`uid`参数与自己的mid不匹配 | +| msg | str | 错误信息 | 成功时为空文本 | +| message | str | 错误信息 | 同`msg` | +| data | obj | 数据本体 | | -data对象: +`data`对象： -| 字段 | 类型 | 内容 | -| --- | --- | --- | -| groups | obj[] | 内容分组(好像是根据关注列表分) | -| \_gt_ | num | 0 | +| 字段 | 类型 | 内容 | 备注 | +| ------ | ----- | -------- | -------------------------------------------- | +| groups | array | 用户分组 | 根据是否关注该用户来分组，未找到用户时无此项 | +| \_gt\_ | num | 0 | **作用尚不明确** | -group对象: +`groups`数组： -| 字段 | 类型 | 内容 | -| --- | --- | --- | -| group_type | num | 2:我的关注
4:其他 | -| group_name | str | 分组名字 | -| items | obj[] | 用户信息 | +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---- | +| 0 | obj | 分组1 | | +| n | obj | 分组(n+1) | | +| …… | obj | …… | …… | -item对象: +`groups`数组中的对象： -| 字段 | 类型 | 内容 | -| --- | --- | --- | -| uid | num | 用户id | -| uname | str | 用户昵称 | -| face | str | 用户头像url | -| fans | num | 用户粉丝数 | -| official_verify_type | num | 认证信息? | +| 字段 | 类型 | 内容 | 备注 | +| ---------- | ----- | ---------------- | ------------------------ | +| group_type | num | 分组类型 | 2：我的关注
4：其他 | +| group_name | str | 分组名称 | `我的关注`或`其他` | +| items | array | 搜索到的用户信息 | 按照认证状态与粉丝数排序 | -
-查看示例 +`items`数组： + +| 项 | 类型 | 内容 | 备注 | +| ---- | ---- | --------- | ---- | +| 0 | obj | 用户1 | | +| n | obj | 用户(n+1) | | +| …… | obj | …… | …… | + +`items`数组中的对象: + +| 字段 | 类型 | 内容 | 备注 | +| -------------------- | ---- | ------------ | ---------------------------------------- | +| uid | num | 用户mid | | +| uname | str | 用户昵称 | | +| face | str | 用户头像url | | +| fans | num | 用户粉丝数 | | +| official_verify_type | num | 用户认证状态 | -1：无
0：个人认证
1：机构认证 | + +**示例：** + +搜索关键字为`社会易`的用户 ```shell -# 搜索关键字:社会易 -curl 'https://api.vc.bilibili.com/dynamic_mix/v1/dynamic_mix/at_search?uid=15858903&keyword=%e7%a4%be%e4%bc%9a%e6%98%93' \ - -H 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:93.0) Gecko/20100101 Firefox/93.0' -H 'Accept: application/json, text/plain, */*' \ - -H 'Referer: https://t.bilibili.com/' \ - -H 'Cookie: SESSDATA=******' +curl -G 'https://api.vc.bilibili.com/dynamic_mix/v1/dynamic_mix/at_search' \ +--data-urlencode 'uid=15858903' \ +--data-urlencode 'keyword=社会易' \ +-b 'SESSDATA=xxx' ``` +
+查看响应示例： + ```json { "code": 0, @@ -77,7 +96,7 @@ curl 'https://api.vc.bilibili.com/dynamic_mix/v1/dynamic_mix/at_search?uid=15858 "uid": 293793435, "uname": "社会易姐QwQ", "face": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg", - "fans": 1179, + "fans": 3578, "official_verify_type": -1 } ] @@ -87,24 +106,38 @@ curl 'https://api.vc.bilibili.com/dynamic_mix/v1/dynamic_mix/at_search?uid=15858 "group_name": "其他", "items": [ { - "uid": 250129011, - "uname": "社会小伙肖子易", - "face": "https://i0.hdslb.com/bfs/face/2ae12d7f71173baa8e00c4cfe97acb5a3de31566.jpg", + "uid": 484031754, + "uname": "社会易老师", + "face": "https://i0.hdslb.com/bfs/face/dbc456bdec5e7a4806c9d0311d95ebcc6be674cf.jpg", + "fans": 21169, + "official_verify_type": -1 + }, + { + "uid": 442101413, + "uname": "社会李易儒", + "face": "https://i2.hdslb.com/bfs/face/311cecf9298158b8a5f47ed3e641328ab5c0cfcd.jpg", + "fans": 10, + "official_verify_type": -1 + }, + { + "uid": 3546589855484501, + "uname": "日本国立貿易株式会社", + "face": "https://i2.hdslb.com/bfs/face/2dad05e4748b5e91e1ec5d3c5d4f0904a5bcdaf0.jpg", "fans": 7, "official_verify_type": -1 }, { - "uid": 394873001, - "uname": "社会你易叔", - "face": "https://i2.hdslb.com/bfs/face/bde2811aa895e349036aba9ece5630bcd1341ff0.jpg", - "fans": 5, + "uid": 250129011, + "uname": "社会小伙肖子易", + "face": "https://i0.hdslb.com/bfs/face/2ae12d7f71173baa8e00c4cfe97acb5a3de31566.jpg", + "fans": 6, "official_verify_type": -1 }, { "uid": 486568790, "uname": "社会主义接班人小易", "face": "https://i2.hdslb.com/bfs/face/1ebb0d4aa8e2c4b532f82983503ec38b62a1820f.jpg", - "fans": 3, + "fans": 4, "official_verify_type": -1 }, { @@ -114,13 +147,6 @@ curl 'https://api.vc.bilibili.com/dynamic_mix/v1/dynamic_mix/at_search?uid=15858 "fans": 2, "official_verify_type": -1 }, - { - "uid": 496622388, - "uname": "社会你易哥", - "face": "https://i0.hdslb.com/bfs/face/daac5514a7622741f767c68b1cbc6b91e60b4798.jpg", - "fans": 1, - "official_verify_type": -1 - }, { "uid": 457675287, "uname": "易社会", @@ -129,10 +155,66 @@ curl 'https://api.vc.bilibili.com/dynamic_mix/v1/dynamic_mix/at_search?uid=15858 "official_verify_type": -1 }, { - "uid": 123270058, - "uname": "周易社会", - "face": "https://i1.hdslb.com/bfs/face/c6100396729112230deb3b0972db1504e9ce21bf.jpg", - "fans": 1, + "uid": 1602175830, + "uname": "不谦易会社恐", + "face": "https://i0.hdslb.com/bfs/face/de6afbda484e114b7cedeb621c3cbbaef7800988.jpg", + "fans": 0, + "official_verify_type": -1 + }, + { + "uid": 155817540, + "uname": "社会易总", + "face": "https://i0.hdslb.com/bfs/face/member/noface.jpg", + "fans": 8, + "official_verify_type": -1 + }, + { + "uid": 3546578331634371, + "uname": "社会存在与社会易逝", + "face": "https://i0.hdslb.com/bfs/face/member/noface.jpg", + "fans": 0, + "official_verify_type": -1 + }, + { + "uid": 1983403996, + "uname": "社会易姐QAQ", + "face": "https://i0.hdslb.com/bfs/face/member/noface.jpg", + "fans": 0, + "official_verify_type": -1 + }, + { + "uid": 408471763, + "uname": "社会易大佬人狠话不多", + "face": "https://i1.hdslb.com/bfs/face/510cde8f4e3eb27aa50177d619a4200bb501797b.jpg", + "fans": 0, + "official_verify_type": -1 + }, + { + "uid": 384672256, + "uname": "社会易轩", + "face": "https://i1.hdslb.com/bfs/face/7324adb53362527a1bf5f20141a6ae4307011ea7.jpg", + "fans": 0, + "official_verify_type": -1 + }, + { + "uid": 284984452, + "uname": "社会易哥", + "face": "https://i0.hdslb.com/bfs/face/member/noface.jpg", + "fans": 0, + "official_verify_type": -1 + }, + { + "uid": 249112673, + "uname": "社会易姐", + "face": "https://i0.hdslb.com/bfs/face/member/noface.jpg", + "fans": 0, + "official_verify_type": -1 + }, + { + "uid": 167967213, + "uname": "社会易大佬", + "face": "https://i0.hdslb.com/bfs/face/member/noface.jpg", + "fans": 0, "official_verify_type": -1 } ] diff --git a/docs/user/info.md b/docs/user/info.md index d7f5fbf..7f3f358 100644 --- a/docs/user/info.md +++ b/docs/user/info.md @@ -943,7 +943,7 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------------- | ------ | ------------------- | -| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔 | +| uids | nums | 目标用户的mid列表 | 必要 | 每个成员间用`,`分隔 | **json回复：** @@ -1206,7 +1206,7 @@ curl -G 'https://api.bilibili.com/x/polymer/pc-electron/v1/user/cards' \ | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ------ | ---- | ----------------- | ------ | --------------------------------------------------------------------- | -| uids | nums | 目标用户的UID列表 | 必要 | 每个成员间用`,`分隔，最多50个成员，若超过此限制则返回的`data`数组为空 | +| uids | nums | 目标用户的mid列表 | 必要 | 每个成员间用`,`分隔，最多50个成员，若超过此限制则返回的`data`数组为空 | **json回复：** From d4f358b57316f8bcdc7e10945ddc55fd2d7eaa0c Mon Sep 17 00:00:00 2001 From: wuziqian211 <65224318+wuziqian211@users.noreply.github.com> Date: Wed, 7 Aug 2024 04:22:22 +0800 Subject: [PATCH 11/11] Update info.md --- docs/user/info.md | 20 +++++++++----------- 1 file changed, 9 insertions(+), 11 deletions(-) diff --git a/docs/user/info.md b/docs/user/info.md index 18f12b4..47234f1 100644 --- a/docs/user/info.md +++ b/docs/user/info.md @@ -937,24 +937,22 @@ curl -G 'https://api.bilibili.com/x/space/myinfo' \ *请求方式：GET* -可以同时获取较多的用户信息（据测试可以一次性获取 2000 多个用户的信息；若获取更多用户信息可能会返回 -504 `服务调用超时`） - **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -| ------ | ---- | ----------------- | ------ | ------------------- | -| uids | nums | 目标用户的mid列表 | 必要 | 每个成员间用`,`分隔 | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ----------------- | ------ | ---------------------------------- | +| uids | nums | 目标用户的mid列表 | 必要 | 每个成员间用`,`分隔，最多200个成员 | **json回复：** 根对象： -| 字段 | 类型 | 内容 | 备注 | -| ------- | ----- | -------- | --------------------------- | -| code | num | 返回值 | 0：成功
-400：请求错误 | -| message | str | 错误信息 | 默认为0 | -| ttl | num | 1 | | -| data | obj | 信息本体 | 用户信息随机排序 | +| 字段 | 类型 | 内容 | 备注 | +| ------- | ----- | -------- | -------------------------------------------------------- | +| code | num | 返回值 | 0：成功
-400：请求错误
40143：批量大小超过限制 | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | 用户信息随机排序 | `data`对象：