From 252178292b943640e4943df4c12e6a0999216c02 Mon Sep 17 00:00:00 2001 From: SocialSisterYi <1440239038@qq.com> Date: Fri, 26 May 2023 12:13:49 +0800 Subject: [PATCH] =?UTF-8?q?update=E3=80=90=E7=94=A8=E6=88=B7=E4=BF=A1?= =?UTF-8?q?=E6=81=AF=E3=80=91=E3=80=90=E7=94=A8=E6=88=B7=E6=8A=95=E7=A8=BF?= =?UTF-8?q?=E8=A7=86=E9=A2=91=E3=80=91APIDoc?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/misc/errcode.md | 1 + docs/user/info.md | 523 ++++++++++++++++++++----------------------- docs/user/space.md | 413 ++++++++++++++++++++++------------ 3 files changed, 511 insertions(+), 426 deletions(-) diff --git a/docs/misc/errcode.md b/docs/misc/errcode.md index ad11f62..7e3d4a7 100644 --- a/docs/misc/errcode.md +++ b/docs/misc/errcode.md @@ -57,4 +57,5 @@ | -688 | 地理区域限制 | | -689 | 版权限制 | | -701 | 扣节操失败 | +| -799 | 请求过于频繁，请稍后再试 | |-8888|对不起，服务器开小差了~ (ಥ﹏ಥ)| diff --git a/docs/user/info.md b/docs/user/info.md index 42fbbd0..46c8100 100644 --- a/docs/user/info.md +++ b/docs/user/info.md @@ -4,70 +4,76 @@ ## 用户空间详细信息 -> https://api.bilibili.com/x/space/acc/info +> https://api.bilibili.com/x/space/wbi/acc/info *请求方式：GET* -认证方式：Cookie(SESSDATA) +认证方式：Cookie（SESSDATA） + +鉴权方式：[Wbi 签名](../misc/sign/wbi.md) + +~~该接口的旧版 API ：https://api.bilibili.com/x/space/acc/info~~（已废弃，不建议使用） **url参数：** -| 参数名 | 类型 | 内容 | 必要性 | 备注 | -|-----|-----|---------|-----|-----| -| mid | num | 目标用户mid | 必要 | | +| 参数名 | 类型 | 内容 | 必要性 | 备注 | +| ------ | ---- | ----------- | ------ | ------------------------------------ | +| mid | num | 目标用户mid | 必要 | | +| w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) | +| wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) | **json回复：** 根对象： -| 字段 | 类型 | 内容 | 备注 | -|---------|-----|------|---------------------| -| code | num | 返回值 | 0：成功
-400：请求错误 | -| message | str | 错误信息 | 默认为0 | -| ttl | num | 1 | | -| data | obj | 信息本体 | | +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0：成功
-400：请求错误
-403：访问权限不足
-404：用户不存在（如注销账号） | +| message | str | 错误信息 | 默认为0 | +| ttl | num | 1 | | +| data | obj | 信息本体 | | `data`对象： -| 字段 | 类型 | 内容 | 备注 | -|------------------|------|------------|--------------------------------------------------------------------------------------------------| -| mid | num | mid | | -| name | str | 昵称 | | -| sex | str | 性别 | 男/女/保密 | -| face | str | 头像链接 | | -| face_nft | num | 是否为 nft 头像 | `0`不是nft头像
`1`是 nft 头像 | -| face_nft_type | num | | 0,1 | -| sign | str | 签名 | | +| 字段 | 类型 | 内容 | 备注 | +| ---------------- | ---- | ---------------- | ------------------------------------------------------------ | +| mid | num | mid | | +| name | str | 昵称 | | +| sex | str | 性别 | 男/女/保密 | +| face | str | 头像链接 | | +| face_nft | num | 是否为 NFT 头像 | 0：不是 NFT 头像
1：是 NFT 头像 | +| face_nft_type | num | NFT 头像类型？ | | +| sign | str | 签名 | | | rank | num | 用户权限等级 | 目前应该无任何作用
5000：0级未答题
10000：普通会员
20000：字幕君
25000：VIP
30000：真·职人
32000：管理员 | -| level | num | 当前等级 | 0-6级 | -| jointime | num | 注册时间 | 此接口返回恒为`0` | -| moral | num | 节操值 | 此接口返回恒为`0` | -| silence | num | 封禁状态 | 0：正常
1：被封 | -| coins | num | 硬币数 | 需要登录(Cookie)
只能查看自己的
默认为0 | -| fans_badge | bool | 是否具有粉丝勋章 | false：无
true：有 | -| fans_medal | obj | 粉丝勋章信息 | | -| official | obj | 认证信息 | | -| vip | obj | 会员信息 | | -| pendant | obj | 头像框信息 | | -| nameplate | obj | 勋章信息 | | -| user_honour_info | obj | | | -| is_followed | bool | 是否关注此用户 | true：已关注
false：未关注
需要登录(Cookie)
未登录恒为false | -| top_photo | str | 主页头图链接 | | -| theme | obj | 空 | **作用尚不明确** | -| sys_notice | obj | 系统通知 | 无内容则为空对象
主要用于展示如用户争议、纪念账号等等 | -| live_room | obj | 直播间信息 | | -| birthday | str | 生日 | MM-DD
如设置隐私为空 | -| school | obj | 学校 | | -| profession | obj | 专业资质信息 | | -| tags | null | 个人标签 | | -| series | obj | | | -| is_senior_member | num | 是否为硬核会员 | 0：否
1：是 | -| mcn_info | null | | | -| gaia_res_type | num | | | -| gaia_data | null | | | -| is_risk | bool | | | -| elec | obj | 充电信息 | | -| contract | obj | 是否显示老粉计划 | | +| level | num | 当前等级 | 0-6 级 | +| jointime | num | 注册时间 | 此接口返回恒为`0` | +| moral | num | 节操值 | 此接口返回恒为`0` | +| silence | num | 封禁状态 | 0：正常
1：被封 | +| coins | num | 硬币数 | 需要登录（Cookie）
只能查看自己的
默认为`0` | +| fans_badge | bool | 是否具有粉丝勋章 | false：无
true：有 | +| fans_medal | obj | 粉丝勋章信息 | | +| official | obj | 认证信息 | | +| vip | obj | 会员信息 | | +| pendant | obj | 头像框信息 | | +| nameplate | obj | 勋章信息 | | +| user_honour_info | obj | （？） | | +| is_followed | bool | 是否关注此用户 | true：已关注
false：未关注
需要登录（Cookie）
未登录恒为`false` | +| top_photo | str | 主页头图链接 | | +| theme | obj | （？） | | +| sys_notice | obj | 系统通知 | 无内容则为空对象
主要用于展示如用户争议、纪念账号等等的小黄条 | +| live_room | obj | 直播间信息 | | +| birthday | str | 生日 | MM-DD
如设置隐私为空 | +| school | obj | 学校 | | +| profession | obj | 专业资质信息 | | +| tags | null | 个人标签 | | +| series | obj | | | +| is_senior_member | num | 是否为硬核会员 | 0：否
1：是 | +| mcn_info | null | （？） | | +| gaia_res_type | num | （？） | | +| gaia_data | null | （？） | | +| is_risk | bool | （？） | | +| elec | obj | 充电信息 | | +| contract | obj | 是否显示老粉计划 | | `rank`示例 @@ -108,29 +114,29 @@ `data`中的`official`对象： -| 字段 | 类型 | 内容 | 备注 | -|-------|-----|------|-----------------------------------------| -| role | num | 认证类型 | 见[用户认证类型一览](official_role.md) | -| title | str | 认证信息 | 无为空 | -| desc | str | 认证备注 | 无为空 | -| type | num | 是否认证 | -1：无
0：个人认证
1：机构认证 | +| 字段 | 类型 | 内容 | 备注 | +| ----- | ---- | -------- | ---------------------------------------- | +| role | num | 认证类型 | 见 [用户认证类型一览](official_role.md) | +| title | str | 认证信息 | 无为空 | +| desc | str | 认证备注 | 无为空 | +| type | num | 是否认证 | -1：无
0：个人认证
1：机构认证 | `data`中的`vip`对象： -| 字段 | 类型 | 内容 | 备注 | -|----------------------|-----|-----------|----------------------------------------------| -| type | num | 会员类型 | 0：无
1：月大会员
2：年度及以上大会员 | -| status | num | 会员状态 | 0：无
1：有 | -| due_date | num | 会员过期时间 | Unix时间戳(毫秒) | -| vip_pay_type | num | 支付类型 | 0：未支付（常见于官方账号）
1：已支付（以正常渠道获取的大会员均为此值） | -| theme_type | num | 0 | 作用尚不明确 | -| label | obj | 会员标签 | | -| avatar_subscript | num | 是否显示会员图标 | 0：不显示
1：显示 | -| nickname_color | str | 会员昵称颜色 | 颜色码，一般为`#FB7299`，曾用于愚人节改变大会员配色 | -| role | num | 大角色类型 | 1：月度大会员
3：年度大会员
7：十年大会员
15：百年大会员 | -| avatar_subscript_url | str | 大会员角标地址 | | -| tv_vip_status | num | 电视大会员状态 | 0：未开通 | -| tv_vip_pay_type | num | 电视大会员支付类型 | | +| 字段 | 类型 | 内容 | 备注 | +| -------------------- | ---- | ------------------ | ------------------------------------------------------------ | +| type | num | 会员类型 | 0：无
1：月大会员
2：年度及以上大会员 | +| status | num | 会员状态 | 0：无
1：有 | +| due_date | num | 会员过期时间 | 毫秒时间戳 | +| vip_pay_type | num | 支付类型 | 0：未支付（常见于官方账号）
1：已支付（以正常渠道获取的大会员均为此值） | +| theme_type | num | 0 | 作用尚不明确 | +| label | obj | 会员标签 | | +| avatar_subscript | num | 是否显示会员图标 | 0：不显示
1：显示 | +| nickname_color | str | 会员昵称颜色 | 颜色码，一般为`#FB7299`，曾用于愚人节改变大会员配色 | +| role | num | 大角色类型 | 1：月度大会员
3：年度大会员
7：十年大会员
15：百年大会员 | +| avatar_subscript_url | str | 大会员角标地址 | | +| tv_vip_status | num | 电视大会员状态 | 0：未开通 | +| tv_vip_pay_type | num | 电视大会员支付类型 | | `vip`中的`label`对象： @@ -219,19 +225,19 @@ `sys_notice`示例 -| id | content | url | notice_type | 示例用户 | -|-----|-------------------------------------------------|-----|-------------|-------------------------------------------------------------------------------------------------| -| 5 | 该用户存在争议行为，已冻结其帐号功能的使用 | | 1 | [82385070](https://space.bilibili.com/82385070) | -| 8 | 该用户存在较大争议，请谨慎甄别其内容 | | 1 | [28062215](https://space.bilibili.com/28062215) | -| 11 | 该账号涉及合约争议，暂冻结其账号功能使用。详见公告-> | | 1 | -| 16 | 该UP主内容存在争议，请注意甄别视频内信息 | | 1 | [382534165](https://space.bilibili.com/382534165) | -| 20 | 请允许我们在此献上最后的告别，以此纪念其在哔哩哔哩留下的回忆与足迹。请点此查看纪念账号相关说明 | | 2 | -| 22 | 该账号涉及合约诉讼，封禁其账号使用。 | | -| 24 | 该账号涉及合约争议，暂冻结其账号功能使用。 | | 1 | [291229008](https://space.bilibili.com/291229008) | -| 25 | 该用户涉及严重指控，暂冻结其账号功能使用 | | 1 | [81447581](https://space.bilibili.com/81447581) | -| 31 | 该用户涉及严重指控，暂冻结其账号功能使用 | | 1 | [22439273](https://space.bilibili.com/22439273) | -| 34 | 该用户涉及严重指控，暂冻结其账号功能使用 | | 1 | [1640486775](https://space.bilibili.com/1640486775) | -| 36 | 该账户存在争议，请谨慎甄别 | | 1 | [198297](https://space.bilibili.com/198297)
[18149131](https://space.bilibili.com/18149131) | +| id | content | notice_type | 示例用户 | +|-----|-------------------------------------------------|-------------|-------------------------------------------------------------------------------------------------| +| 5 | 该用户存在争议行为，已冻结其帐号功能的使用 | 1 | [82385070](https://space.bilibili.com/82385070) | +| 8 | 该用户存在较大争议，请谨慎甄别其内容 | 1 | [28062215](https://space.bilibili.com/28062215) | +| 11 | 该账号涉及合约争议，暂冻结其账号功能使用。详见公告-> | 1 || +| 16 | 该UP主内容存在争议，请注意甄别视频内信息 | 1 | [382534165](https://space.bilibili.com/382534165) | +| 20 | 请允许我们在此献上最后的告别，以此纪念其在哔哩哔哩留下的回忆与足迹。请点此查看纪念账号相关说明 | 2 |[212535360](https://space.bilibili.com/212535360)| +|22| 该账号涉及合约诉讼，封禁其账号使用 | || +| 24 | 该账号涉及合约争议，暂冻结其账号功能使用 | 1 | [291229008](https://space.bilibili.com/291229008) | +| 25 | 该用户涉及严重指控，暂冻结其账号功能使用 | 1 | [81447581](https://space.bilibili.com/81447581) | +| 31 | 该用户涉及严重指控，暂冻结其账号功能使用 | 1 | [22439273](https://space.bilibili.com/22439273) | +| 34 | 该用户涉及严重指控，暂冻结其账号功能使用 | 1 | [1640486775](https://space.bilibili.com/1640486775) | +| 36 | 该账户存在争议，请谨慎甄别 | 1 | [198297](https://space.bilibili.com/198297)
[18149131](https://space.bilibili.com/18149131) | `data`中的`live_room`对象： @@ -314,12 +320,14 @@ **示例：** -查询用户`mid=2`的详细信息 +查询用户`mid=2`的详细信息，Wbi 签名的 `wts`、`w_rid`生成方式详见 [Wbi 签名](../misc/sign/wbi.md) 文档 ```shell -curl -G 'https://api.bilibili.com/x/space/acc/info' \ ---data-urlencode 'mid=2' \ --b 'SESSDATA=xxx' +curl -G 'https://api.bilibili.com/x/space/wbi/acc/info' \ + --data-urlencode 'mid=2' \ + --data-urlencode 'wts=1685070149' \ + --data-urlencode 'w_rid=f7b376124782ae8cb42c56fdd69144ed' \ + -b 'SESSDATA=xxx' ```
@@ -327,204 +335,163 @@ curl -G 'https://api.bilibili.com/x/space/acc/info' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "mid": 2, - "name": "碧诗", - "sex": "男", - "face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg", - "face_nft": 0, - "face_nft_type": 0, - "sign": "https://kami.im 直男过气网红 # We Are Star Dust", - "rank": 20000, - "level": 6, - "jointime": 0, - "moral": 0, - "silence": 0, - "coins": 0, - "fans_badge": true, - "fans_medal": { - "show": true, - "wear": true, - "medal": { - "uid": 2, - "target_id": 335115, - "medal_id": 45408, - "level": 21, - "medal_name": "伍千万", - "medal_color": 1725515, - "intimacy": 1980, - "next_intimacy": 2000, - "day_limit": 250000, - "medal_color_start": 1725515, - "medal_color_end": 5414290, - "medal_color_border": 1725515, - "is_lighted": 1, - "light_status": 1, - "wearing_status": 1, - "score": 50001980 - } - }, - "official": { - "role": 2, - "title": "bilibili创始人（站长）", - "desc": "", - "type": 0 - }, - "vip": { - "type": 2, - "status": 1, - "due_date": 3909916800000, - "vip_pay_type": 0, - "theme_type": 0, - "label": { - "path": "", - "text": "十年大会员", - "label_theme": "ten_annual_vip", - "text_color": "#FFFFFF", - "bg_style": 1, - "bg_color": "#FB7299", - "border_color": "", - "use_img_label": true, - "img_label_uri_hans": "", - "img_label_uri_hant": "", - "img_label_uri_hans_static": "https://i0.hdslb.com/bfs/activity-plat/static/20221008/0597543265563f522fad443825cff578/O9l2i8GdaZ.png", - "img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/8u7iRTPE7N.png" - }, - "avatar_subscript": 1, - "nickname_color": "#FB7299", - "role": 7, - "avatar_subscript_url": "", - "tv_vip_status": 1, - "tv_vip_pay_type": 0 - }, - "pendant": { - "pid": 32257, - "name": "EveOneCat2", - "image": "https://i2.hdslb.com/bfs/garb/item/488870931b1bba66da36d22848f0720480d3d79a.png", - "expire": 0, - "image_enhance": "https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp", - "image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png" - }, - "nameplate": { - "nid": 10, - "name": "见习偶像", - "image": "https://i1.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png", - "image_small": "https://i1.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png", - "level": "普通勋章", - "condition": "所有自制视频总播放数>=10万" - }, - "user_honour_info": { - "mid": 0, - "colour": null, - "tags": [] - }, - "is_followed": false, - "top_photo": "http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png", - "theme": {}, - "sys_notice": {}, - "live_room": { - "roomStatus": 1, - "liveStatus": 0, - "url": "https://live.bilibili.com/1024?broadcast_type=0&is_room_feed=0", - "title": "试图恰鸡", - "cover": "http://i0.hdslb.com/bfs/live/new_room_cover/96ee5bfd0279a0f18b190340334f43f473038288.jpg", - "roomid": 1024, - "roundStatus": 0, - "broadcast_type": 0, - "watched_show": { - "switch": true, - "num": 14, - "text_small": "14", - "text_large": "14人看过", - "icon": "https://i0.hdslb.com/bfs/live/a725a9e61242ef44d764ac911691a7ce07f36c1d.png", - "icon_location": "", - "icon_web": "https://i0.hdslb.com/bfs/live/8d9d0f33ef8bf6f308742752d13dd0df731df19c.png" - } - }, - "birthday": "09-19", - "school": { - "name": "" - }, - "profession": { - "name": "", - "department": "", - "title": "", - "is_show": 0 - }, - "tags": null, - "series": { - "user_upgrade_status": 3, - "show_upgrade_window": false - }, - "is_senior_member": 1, - "mcn_info": null, - "gaia_res_type": 0, - "gaia_data": null, - "is_risk": false, - "elec": { - "show_info": { - "show": true, - "state": 1, - "title": "", - "icon": "", - "jump_url": "" - } + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "mid": 2, + "name": "碧诗", + "sex": "男", + "face": "https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg", + "face_nft": 0, + "face_nft_type": 0, + "sign": "https://kami.im 直男过气网红 # We Are Star Dust", + "rank": 20000, + "level": 6, + "jointime": 0, + "moral": 0, + "silence": 0, + "coins": 0, + "fans_badge": true, + "fans_medal": { + "show": true, + "wear": true, + "medal": { + "uid": 2, + "target_id": 335115, + "medal_id": 45408, + "level": 21, + "medal_name": "伍千万", + "medal_color": 1725515, + "intimacy": 1980, + "next_intimacy": 2000, + "day_limit": 250000, + "medal_color_start": 1725515, + "medal_color_end": 5414290, + "medal_color_border": 1725515, + "is_lighted": 1, + "light_status": 1, + "wearing_status": 1, + "score": 50001980 + } + }, + "official": { + "role": 2, + "title": "bilibili创始人（站长）", + "desc": "", + "type": 0 + }, + "vip": { + "type": 2, + "status": 1, + "due_date": 3931344000000, + "vip_pay_type": 0, + "theme_type": 0, + "label": { + "path": "", + "text": "十年大会员", + "label_theme": "ten_annual_vip", + "text_color": "#FFFFFF", + "bg_style": 1, + "bg_color": "#FB7299", + "border_color": "", + "use_img_label": true, + "img_label_uri_hans": "https://i0.hdslb.com/bfs/activity-plat/static/20220608/e369244d0b14644f5e1a06431e22a4d5/wltavwHAkL.gif", + "img_label_uri_hant": "", + "img_label_uri_hans_static": "https://i0.hdslb.com/bfs/vip/802418ff03911645648b63aa193ba67997b5a0bc.png", + "img_label_uri_hant_static": "https://i0.hdslb.com/bfs/activity-plat/static/20220614/e369244d0b14644f5e1a06431e22a4d5/8u7iRTPE7N.png" + }, + "avatar_subscript": 1, + "nickname_color": "#FB7299", + "role": 7, + "avatar_subscript_url": "", + "tv_vip_status": 1, + "tv_vip_pay_type": 0, + "tv_due_date": 2000822400 + }, + "pendant": { + "pid": 32257, + "name": "EveOneCat2", + "image": "https://i2.hdslb.com/bfs/garb/item/488870931b1bba66da36d22848f0720480d3d79a.png", + "expire": 0, + "image_enhance": "https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp", + "image_enhance_frame": "https://i2.hdslb.com/bfs/garb/item/4316a3910bb0bd6f2f1c267a3e9187f0b9fe5bd0.png" + }, + "nameplate": { + "nid": 10, + "name": "见习偶像", + "image": "https://i2.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png", + "image_small": "https://i2.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png", + "level": "普通勋章", + "condition": "所有自制视频总播放数>=10万" + }, + "user_honour_info": { + "mid": 0, + "colour": null, + "tags": [] + }, + "is_followed": true, + "top_photo": "http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png", + "theme": {}, + "sys_notice": {}, + "live_room": { + "roomStatus": 1, + "liveStatus": 0, + "url": "https://live.bilibili.com/1024?broadcast_type=0&is_room_feed=0", + "title": "试图恰鸡", + "cover": "http://i0.hdslb.com/bfs/live/new_room_cover/96ee5bfd0279a0f18b190340334f43f473038288.jpg", + "roomid": 1024, + "roundStatus": 0, + "broadcast_type": 0, + "watched_show": { + "switch": true, + "num": 19, + "text_small": "19", + "text_large": "19人看过", + "icon": "https://i0.hdslb.com/bfs/live/a725a9e61242ef44d764ac911691a7ce07f36c1d.png", + "icon_location": "", + "icon_web": "https://i0.hdslb.com/bfs/live/8d9d0f33ef8bf6f308742752d13dd0df731df19c.png" + } + }, + "birthday": "09-19", + "school": { + "name": "" + }, + "profession": { + "name": "", + "department": "", + "title": "", + "is_show": 0 + }, + "tags": null, + "series": { + "user_upgrade_status": 3, + "show_upgrade_window": false + }, + "is_senior_member": 0, + "mcn_info": null, + "gaia_res_type": 0, + "gaia_data": null, + "is_risk": false, + "elec": { + "show_info": { + "show": true, + "state": 1, + "title": "", + "icon": "", + "jump_url": "?oid=2" + } + }, + "contract": { + "is_display": false, + "is_follow_display": false + } } - } } ```
-**查询到的信息解析如下：** - -**用户昵称为**：碧诗 - -**性别**：男 - -**用户的头像为**： - -https://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg - - - -**等级**：6级 - -**生日**：09-19 - -**粉丝勋章状态**：拥有 - -**认证**：个人认证 - -**认证名称**： bilibili创始人(站长) - -**大会员类型**：年度 - -**大会员状态**：已开通 - -**电视大会员状态**：已开通 - -**头像框**：EveOneCat2 - -https://i2.hdslb.com/bfs/garb/item/5974f17f9d96a88bafba2f6d18d647a486e88312.webp - - - -**粉丝勋章**： 见习偶像 - -https://i1.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png - - - -**空间头图**： - -https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png - -![](https://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png) - ## 用户名片信息 > https://api.bilibili.com/x/web-interface/card diff --git a/docs/user/space.md b/docs/user/space.md index 2e53826..6bce61e 100644 --- a/docs/user/space.md +++ b/docs/user/space.md @@ -2624,12 +2624,12 @@ curl -L -X GET 'https://api.bilibili.com/x/space/like/video?vmid=15858903' > https://api.bilibili.com/x/space/wbi/arc/search -> ~~https://api.bilibili.com/x/space/arc/search （旧 API，现已不可用）~~ - -PS：旧 API 现已不可使用，活返回`code=-799` - *请求方式：GET* +鉴权方式：[Wbi 签名](../misc/sign/wbi.md) + +~~该接口的旧版 API ：https://api.bilibili.com/x/space/arc/search~~（已废弃，不建议使用） + **header字段：** 必须要有 `user-agent`，且不能为 `空字符串`，以及含有 `python`、`node`、`curl` 等的字符串 @@ -2644,6 +2644,8 @@ PS：旧 API 现已不可使用，活返回`code=-799` | keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 | | pn | num | 页码 | 非必要 | | | ps | num | 每页项数 | 非必要 | 最小 1，最大 50，默认 30 | +| w_rid | str | Wbi 签名 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) | +| wts | num | 当前时间戳 | 必要 | 详见 [Wbi 签名](../misc/sign/wbi.md) | **json回复：** @@ -2651,28 +2653,29 @@ PS：旧 API 现已不可使用，活返回`code=-799` | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0：成功
-400：请求错误
-412：请求被拦截
-1200：被降级过滤的请求(一种意义不明的偶发状况) | +| code | num | 返回值 | 0：成功
-400：请求错误
-403：访问权限不足
-412：请求被拦截
-1200：被降级过滤的请求(一种意义不明的偶发状况) | | message | str | 错误信息 | 默认为 0 | | ttl | num | 1 | | | data | obj | 信息本体 | | `data`对象： -| 字段 | 类型 | 内容 | 备注 | -|-----------------|------|----------|-----| -| list | obj | 列表信息 | | -| page | obj | 页面信息 | | -| episodic_button | obj | “播放全部“按钮 | | -| is_risk | bool | | | -| gaia_res_type | num | | | -| gaia_data | | | | +| 字段 | 类型 | 内容 | 备注 | +| --------------- | ---- | -------------- | ---- | +| list | obj | 列表信息 | | +| page | obj | 页面信息 | | +| episodic_button | obj | “播放全部“按钮 | | +| is_risk | bool | （？） | | +| gaia_res_type | num | （？） | | +| gaia_data | null | （？） | | `data`中的`list`对象： -| 字段 | 类型 | 内容 | 备注 | -|-------|-------|----------|-----| -| tlist | obj | 投稿视频分区索引 | | -| vlist | array | 投稿视频列表 | | +| 字段 | 类型 | 内容 | 备注 | +| ----- | ----- | ---------------- | ---- | +| tlist | obj | 投稿视频分区索引 | | +| vlist | array | 投稿视频列表 | | +| slist | array | （？） | | `list`中的`tlist`对象： @@ -2701,30 +2704,31 @@ PS：旧 API 现已不可使用，活返回`code=-799` | 字段 | 类型 | 内容 | 备注 | | ---------------- | ---- | -------------- | ------------------------------------------------------------ | -| aid | num | 稿件 avid | | -| author | str | 视频 UP 主 | 不一定为目标用户（合作视频） | -| bvid | str | 稿件 bvid | | | comment | num | 视频评论数 | | -| copyright | str | 稿件类型 | 1：原创
2：转载 | -| created | num | 投稿时间 | 时间戳 | -| description | str | 视频简介 | | -| hide_click | bool | false | 作用尚不明确 | -| is_pay | num | 0 | 作用尚不明确 | -| is_union_video | num | 是否为合作视频 | 0：否
1：是 | -| length | str | 视频长度 | MM:SS | -| mid | num | 视频 UP 主 mid | 不一定为目标用户（合作视频） | -| pic | str | 视频封面 | | -| play | num | 视频播放次数 | 如果视频基本信息API对应的状态为-403视频访问权限不足，数据类型将变为str，如（"play": "--",），于mid79发表的av5132474可见 | -| review | num | 0 | 作用尚不明确 | -| subtitle | str | 空 | 作用尚不明确 | -| title | str | 视频标题 | | | typeid | num | 视频分区 tid | | +| play | num | 视频播放次数 | 如果视频基本信息 API 对应的状态为 -403 视频访问权限不足，数据类型将变为str，如（"play": "--",），于 UID:79 发表的 av5132474 可见 | +| pic | str | 视频封面 | | +| subtitle | str | （？） | | +| description | str | 视频简介 | | +| copyright | str | 稿件类型 | 1：原创
2：转载 | +| title | str | 视频标题 | | +| review | num | （?） | | +| author | str | 视频 UP 主 | 不一定为目标用户（合作视频） | +| mid | num | 视频 UP 主 mid | 不一定为目标用户（合作视频） | +| created | num | 投稿时间 | 秒时间戳 | +| length | str | 视频长度 | MM:SS | | video_review | num | 视频弹幕数 | | -| is_steins_gate | num | 0 | | -| is_live_playback | num | 0 | | -| meta | | | | -| is_avoided | num | 0 | | -| attribute | num | 0 | | +| aid | num | 稿件 avid | | +| bvid | str | 稿件 bvid | | +| hide_click | bool | （？） | | +| is_pay | num | （？） | | +| is_union_video | num | 是否为合作视频 | 0：否
1：是 | +| is_steins_gate | num | （？） | | +| is_live_playback | num | 是否直播回放 | 0：否
1：是 | +| meta | null | （？） | | +| is_avoided | num | （？） | | +| attribute | num | （？） | | +| is_charging_arc | bool | （？） | | `data`中的`page`对象： @@ -2745,13 +2749,17 @@ PS：旧 API 现已不可使用，活返回`code=-799` `pn`（页码）和`ps`（每页项数）只改变`vlist`中成员的多少与内容 -以每页2项查询用户`mid=53456`的第1页投稿视频明细 +以每页 5 项查询用户`mid=53456`的第 1 页投稿视频明细 + +Wbi 签名的 `wts`、`w_rid`生成方式详见 [Wbi 签名](../misc/sign/wbi.md) 文档 ```shell curl -G 'https://api.bilibili.com/x/space/wbi/arc/search' \ --data-urlencode 'mid=53456' \ - --data-urlencode 'ps=2' \ - --data-urlencode 'pn=1' + --data-urlencode 'ps=5' \ + --data-urlencode 'pn=1' \ + --data-urlencode 'wts=1685073645' \ + --data-urlencode 'w_rid=2e49b69235fb3ea9340422ac9382cbc2' ```
@@ -2759,116 +2767,225 @@ curl -G 'https://api.bilibili.com/x/space/wbi/arc/search' \ ```json { - "code": 0, - "message": "0", - "ttl": 1, - "data": { - "list": { - "tlist": { - "1": { - "tid": 1, - "count": 41, - "name": "动画" + "code": 0, + "message": "0", + "ttl": 1, + "data": { + "list": { + "tlist": { + "1": { + "tid": 1, + "count": 42, + "name": "动画" + }, + "3": { + "tid": 3, + "count": 36, + "name": "音乐" + }, + "4": { + "tid": 4, + "count": 85, + "name": "游戏" + }, + "36": { + "tid": 36, + "count": 1, + "name": "知识" + }, + "160": { + "tid": 160, + "count": 51, + "name": "生活" + }, + "211": { + "tid": 211, + "count": 3, + "name": "美食" + }, + "217": { + "tid": 217, + "count": 2, + "name": "动物圈" + } + }, + "vlist": [ + { + "comment": 2727, + "typeid": 17, + "play": 1379744, + "pic": "http://i0.hdslb.com/bfs/archive/d8745a327c56a1d8862054bf88ed1cd3d4cd2a0f.jpg", + "subtitle": "", + "description": "游戏：《塞尔达传说：王国之泪》\n真好玩！一口气玩了五天，到处游山玩水都没怎么顾得上推主线哈哈哈，虽然没能造出高达来，但胡乱折腾也很开心啦！\n我的微博：_warma_", + "copyright": "1", + "title": "【warma】我玩游戏太菜不要笑我！", + "review": 0, + "author": "Warma", + "mid": 53456, + "created": 1684468800, + "length": "27:53", + "video_review": 7538, + "aid": 741294090, + "bvid": "BV1dk4y1L77W", + "hide_click": false, + "is_pay": 0, + "is_union_video": 0, + "is_steins_gate": 0, + "is_live_playback": 0, + "meta": null, + "is_avoided": 0, + "attribute": 0, + "is_charging_arc": false + }, + { + "comment": 2959, + "typeid": 172, + "play": 1601320, + "pic": "http://i2.hdslb.com/bfs/archive/5bc6b4b78787508fec6e5545313a5aac49b420ab.jpg", + "subtitle": "", + "description": "来继续更新我的光遇之旅啦~这次也录到了好几个交到新朋友的瞬间了哈哈哈，每次被陌生人夸的时候都感觉特别不好意思但是又好开心！喜欢这里慢悠悠的氛围~最近夜行季也上线了，来欣赏美丽的月食吧！\n祝大家看得开心啦！", + "copyright": "1", + "title": "【warma】这里的陌生人都热情过头了啊啊啊！", + "review": 0, + "author": "Warma", + "mid": 53456, + "created": 1683434541, + "length": "21:56", + "video_review": 2552, + "aid": 570782455, + "bvid": "BV12z4y1h72d", + "hide_click": false, + "is_pay": 0, + "is_union_video": 0, + "is_steins_gate": 0, + "is_live_playback": 0, + "meta": null, + "is_avoided": 0, + "attribute": 0, + "is_charging_arc": false + }, + { + "comment": 6844, + "typeid": 21, + "play": 3898109, + "pic": "http://i0.hdslb.com/bfs/archive/733239b86fe15c5f07d15872a955e1819dcc1f31.jpg", + "subtitle": "", + "description": "我想试着练习写一本从构思、正文、插画、排版到封面设计全都由自己来完成的书！\n\n虽然这本书未来还不确定，但是我尽力啦~大家如果觉得有哪里做得还不够好请指出来告诉我吧，我还有很多很多需要学习的地方，请大家多多指教啦！\n如果有出版社的编辑老师正在观看此视频的话，请老师们多多指教，希望能够和老师们取得联系：chickenfish@vip.qq.com\n\n电子书文件发在评论区啦~", + "copyright": "1", + "title": "【warma】我要写书啦！！！", + "review": 0, + "author": "Warma", + "mid": 53456, + "created": 1680840000, + "length": "21:55", + "video_review": 15975, + "aid": 909664793, + "bvid": "BV1oM4y1y7Q4", + "hide_click": false, + "is_pay": 0, + "is_union_video": 0, + "is_steins_gate": 0, + "is_live_playback": 0, + "meta": null, + "is_avoided": 0, + "attribute": 0, + "is_charging_arc": false + }, + { + "comment": 2030, + "typeid": 17, + "play": 2272296, + "pic": "http://i0.hdslb.com/bfs/archive/d0d12a011d2a3799a77fa84372372581abdc917c.jpg", + "subtitle": "", + "description": "玩到尽兴为止！\n\n录制/视频制作：warma\n录制/插画：怒九", + "copyright": "1", + "title": "【warma/怒九】陪我打游戏！(胁迫)", + "review": 0, + "author": "Warma", + "mid": 53456, + "created": 1677816000, + "length": "36:42", + "video_review": 9902, + "aid": 482867257, + "bvid": "BV1XT411v76Y", + "hide_click": false, + "is_pay": 0, + "is_union_video": 1, + "is_steins_gate": 0, + "is_live_playback": 0, + "meta": null, + "is_avoided": 0, + "attribute": 0, + "is_charging_arc": false + }, + { + "comment": 12666, + "typeid": 21, + "play": 1892762, + "pic": "http://i0.hdslb.com/bfs/archive/5e712811e893886fb0535a95e1609cb3ba307a39.jpg", + "subtitle": "", + "description": "你好~这是我的一期电台节目，现在也已经是第十一期啦，但是即便没看过前面几期也不会影响观看，因为这是个什么都聊聊看的日常电台嘛~\n \n这期电台内容非常友好、令人安心，只是偶尔有点“问题”，但好在目前还是处于能安全观看的水平，请来看看吧。\n \n录音/视频制作：warma\n我的微博：_warma_\n \n背景插画：认知Renz\n发光粒子素材：K_Lacid \n【视频某处的曲子的staff】\n翻唱：Warma\n曲绘：不鱼\nPV：祈凉_&兽人苦工\n后期：白萝卜音乐工作室\n \n（感谢以上老师的帮助~）", + "copyright": "1", + "title": "【warma爆炸电台】曾经性格阴沉的我正在分享创作心得与日常【第十一期】", + "review": 0, + "author": "Warma", + "mid": 53456, + "created": 1674964800, + "length": "77:24", + "video_review": 68240, + "aid": 990909915, + "bvid": "BV1Ex4y177xd", + "hide_click": false, + "is_pay": 0, + "is_union_video": 0, + "is_steins_gate": 0, + "is_live_playback": 0, + "meta": { + "id": 149941, + "title": "爆炸电台", + "cover": "https://archive.biliimg.com/bfs/archive/b833b4299b3f4252ebe4d2902421aa25ba9e7ccc.jpg", + "mid": 53456, + "intro": "你好！这是我的电台节目《爆炸电台》，这是个什么都聊聊看的日常电台，内容是纯音频的，所以看不看画面都没问题~\n电台的时间比较长，可以拿点零食饮料或者放在一旁慢慢听什么的都很合适~\n祝观看愉快~！", + "sign_state": 0, + "attribute": 140, + "stat": { + "season_id": 149941, + "view": 11824985, + "danmaku": 363116, + "reply": 50348, + "favorite": 343639, + "coin": 665105, + "share": 50804, + "like": 1013864, + "mtime": 1685073652, + "vt": 71631635, + "vv": 0 + }, + "ep_count": 10, + "first_aid": 990909915, + "ptime": 1674964800, + "ep_num": 0 + }, + "is_avoided": 0, + "attribute": 0, + "is_charging_arc": false + } + ], + "slist": [] }, - "3": { - "tid": 3, - "count": 36, - "name": "音乐" + "page": { + "pn": 1, + "ps": 5, + "count": 220 }, - "4": { - "tid": 4, - "count": 82, - "name": "游戏" + "episodic_button": { + "text": "播放全部", + "uri": "//www.bilibili.com/medialist/play/53456?from=space" }, - "36": { - "tid": 36, - "count": 1, - "name": "知识" - }, - "160": { - "tid": 160, - "count": 49, - "name": "生活" - }, - "211": { - "tid": 211, - "count": 3, - "name": "美食" - }, - "217": { - "tid": 217, - "count": 2, - "name": "动物圈" - } - }, - "vlist": [ - { - "comment": 6729, - "typeid": 172, - "play": 2171260, - "pic": "http://i2.hdslb.com/bfs/archive/9fe04c2acb6678c9a8d1547db211e458ea70982c.jpg", - "subtitle": "", - "description": "好开心能和几千人一起看音乐会！真的震撼到我了，它给我带来的冲击感远超出了我的想象……光遇这场音乐会会一直持续到元旦哦，大家感兴趣的话也可以来试试吧~\n祝看得开心啦！", - "copyright": "1", - "title": "【warma】我尝试学习交朋友", - "review": 0, - "author": "Warma", - "mid": 53456, - "created": 1671163200, - "length": "23:58", - "video_review": 7931, - "aid": 433873134, - "bvid": "BV1nG411P7hf", - "hide_click": false, - "is_pay": 0, - "is_union_video": 0, - "is_steins_gate": 0, - "is_live_playback": 0, - "meta": null, - "is_avoided": 0, - "attribute": 0 - }, - { - "comment": 3380, - "typeid": 31, - "play": 811600, - "pic": "http://i2.hdslb.com/bfs/archive/7e6c6ec32a0db8684abd660d599644e9d1c43ee4.jpg", - "subtitle": "", - "description": "原曲：BV1iR4y1X7V9\n这首歌是今年生日的时候收到的礼物，真的太好听了！我也想翻唱试试~\n在翻唱中录了一些不一样的小音效，比如卡祖笛和竖笛，还录了些小配音……大家来听听看！\n谢谢原曲staff老师们做出这么有趣的作品，谢谢在这次翻唱中staff老师们的帮助（PV老师甚至根据翻唱版本把曲子的PV做了些修改，加了好多小细节，真的超用心！）\n祝听得开心啦~\n \n【staff表】\n原曲staff：详见BV1iR4y1X7V9\n翻唱：warma\n混音：白萝卜音乐工作室\nPV修改：@颜一bot \n封面：是根", - "copyright": "1", - "title": "【warma】来唱大家送我的歌！《夏天幻游日记》", - "review": 0, - "author": "Warma", - "mid": 53456, - "created": 1670558400, - "length": "02:59", - "video_review": 2343, - "aid": 733323002, - "bvid": "BV18D4y1Y7o6", - "hide_click": false, - "is_pay": 0, - "is_union_video": 0, - "is_steins_gate": 0, - "is_live_playback": 0, - "meta": null, - "is_avoided": 0, - "attribute": 0 - } - ] - }, - "page": { - "pn": 1, - "ps": 2, - "count": 214 - }, - "episodic_button": { - "text": "播放全部", - "uri": "//www.bilibili.com/medialist/play/53456?from=space" - }, - "is_risk": false, - "gaia_res_type": 0, - "gaia_data": null - } + "is_risk": false, + "gaia_res_type": 0, + "gaia_data": null + } } ```