Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

添加【黑名单列表】与【悄悄关注列表】接口 并勘误

Browse Source
This commit is contained in:
SocialSisterYi 2020-11-21 23:56:44 +08:00
parent e7efbd0ae5
commit 3d66604055
5 changed files with 706 additions and 317 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
live/info.md
View File

@ -37,8 +37,8 @@
| liveStatus | num | 直播状态 | 0：未开播<br />1：直播中 |
| url | str | 直播间网页url | |
| title | str | 直播间标题 | |
| cover | str | 直播间封面 | |
| online | num | 直播间人气 | 值为上次直播刷新 |
| cover | str | 直播间封面url | |
| online | num | 直播间人气 | 值为上次直播时刷新 |
| roomid | num | 直播间ID（短号） | |
| broadcast_type | num | 0 | |
| online_hidden | num | 0 | |

96
login/login_info.md
View File

@ -1,6 +1,6 @@
# 登录基本信息
- [登录用户信息1（web端）](#登录用户信息1（web端）)
- [导航栏用户信息](#导航栏用户信息)
- [登录用户信息2（web端）（仅部分）](#登录用户信息2（web端）（仅部分）)
- [登录用户信息（APP端）](#登录用户信息（APP端）)
- [登录用户状态数（双端）](#登录用户状态数（双端）)
@ -8,7 +8,7 @@
---
## 登录用户信息1（web端）
## 导航栏用户信息
> http://api.bilibili.com/nav（带有转义）
>
@ -31,34 +31,34 @@
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------------- | ---- | ---------------- | ------------------------------- |
| isLogin | bool | 是否已登录 | false：未登录<br />true：已登录 |
| email_verified | num | 是否验证邮箱地址 | 0：未验证<br />1：已验证 |
| face | str | 用户头像url | |
| level_info | obj | 等级信息 | |
| mid | num | 用户UID | |
| mobile_verified | num | 是否验证手机号 | 0：未验证<br />1：已验证 |
| money | num | 拥有硬币数 | |
| moral | num | 当前节操值 | 上限70 |
| official | obj | 认证信息 | |
| officialVerify | obj | 认证信息2 | |
| pendant | obj | 头像框信息 | |
| scores | num | 0 | **作用尚不明确** |
| uname | str | 用户昵称 | |
| vipDueDate | num | 大会员到期时间 | 毫秒 时间戳 |
| vipStatus | num | 会员开通状态 | 0：无<br />1：有 |
| vipType | num | 大会员类型 | 0：无<br />1：月度<br />2：年度 |
| vip_pay_type | num | 会员开通状态 | 0：无<br />1：有 |
| vip_theme_type | num | 0 | **作用尚不明确** |
| vip_label | obj | 大会员信息 | |
| vip_avatar_subscript | num | 是否显示会员图标 | 0：不显示<br />1：显示 |
| vip_nickname_color | str | 会员昵称颜色 | 颜色码 |
| wallet | obj | B币信息 | |
| has_shop | bool | false | **作用尚不明确** |
| shop_url | str | 空 | **作用尚不明确** |
| allowance_count | num | 0 | **作用尚不明确** |
| answer_status | num | 0 | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| -------------------- | ---- | ---------------- | ----------------------------------------------- |
| isLogin | bool | 是否已登录 | false：未登录<br />true：已登录 |
| email_verified | num | 是否验证邮箱地址 | 0：未验证<br />1：已验证 |
| face | str | 用户头像url | |
| level_info | obj | 等级信息 | |
| mid | num | 用户UID | |
| mobile_verified | num | 是否验证手机号 | 0：未验证<br />1：已验证 |
| money | num | 拥有硬币数 | |
| moral | num | 当前节操值 | 上限为70 |
| official | obj | 认证信息 | |
| officialVerify | obj | 认证信息2 | |
| pendant | obj | 头像框信息 | |
| scores | num | 0 | 作用尚不明确 |
| uname | str | 用户昵称 | |
| vipDueDate | num | 会员到期时间 | 毫秒 时间戳 |
| vipStatus | num | 会员开通状态 | 0：无<br />1：有 |
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
| vip_pay_type | num | 会员开通状态 | 0：无<br />1：有 |
| vip_theme_type | num | 0 | 作用尚不明确 |
| vip_label | obj | 会员标签 | |
| vip_avatar_subscript | num | 是否显示会员图标 | 0：不显示<br />1：显示 |
| vip_nickname_color | str | 会员昵称颜色 | 颜色码 |
| wallet | obj | B币钱包信息 | |
| has_shop | bool | 是否拥有推广商品 | false：无<br />true：有 |
| shop_url | str | 商品推广页面url | |
| allowance_count | num | 0 | 作用尚不明确 |
| answer_status | num | 0 | 作用尚不明确 |
`data`中的`level_info`对象：
@ -87,29 +87,29 @@
`data`中的`pendant`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ----------- | ---------------- |
| pid | num | 挂件id | |
| name | str | 挂件名称 | |
| image | str | 挂件图片url | |
| expire | num | 0 | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ----------- | ------------ |
| pid | num | 挂件id | |
| name | str | 挂件名称 | |
| image | str | 挂件图片url | |
| expire | num | 0 | 作用尚不明确 |
`data`中的`vip_label`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ---------------- |
| path | str | 空 | **作用尚不明确** |
| text | str | 会员类型文字 | |
| label_theme | str | 会员类型 | |
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------- | ------------------------------------------------------------ |
| path | str | 空 | 作用尚不明确 |
| text | str | 会员名称 | |
| label_theme | str | 会员标签 | vip：大会员<br />annual_vip：年度大会员<br />ten_annual_vip：十年大会员<br />hundred_annual_vip：百年大会员 |
`data`中的`wallet`对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------- | ---------------- |
| mid | num | 登录用户UID | |
| bcoin_balance | num | 拥有B币数 | |
| coupon_balance | num | 每月奖励B币数 | |
| coupon_due_time | num | 0 | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------- | ------------ |
| mid | num | 登录用户UID | |
| bcoin_balance | num | 拥有B币数 | |
| coupon_balance | num | 每月奖励B币数 | |
| coupon_due_time | num | 0 | 作用尚不明确 |
**示例：**
@ -187,7 +187,7 @@ curl 'http://api.bilibili.com/nav' \
</details>
## 登录用户信息2（web端）（仅部分）
## 登录用户信息（仅部分）
> http://account.bilibili.com/home/userInfo

294
user/info.md
View File

@ -39,25 +39,26 @@
| ----------- | ---- | ---------------- | ------------------------------------------------------------ |
| mid | num | UID | |
| name | str | 昵称 | |
| sex | str | 性别 | 男 女 保密 |
| sex | str | 性别 | 男/女/保密 |
| face | str | 头像链接 | |
| sign | str | 签名 | |
| rank | num | 10000 | **作用尚不明确** |
| rank | num | 10000 | |
| level | num | 当前等级 | 0-6级 |
| jointime | num | 0 | **作用尚不明确** |
| moral | num | 0 | **作用尚不明确** |
| jointime | num | 0 | |
| moral | num | 0 | |
| silence | num | 封禁状态 | 0：正常<br />1：被封 |
| birthday | str | 生日 | MM-DD |
| birthday | str | 生日 | MM-DD<br />如设置隐私为空 |
| coins | num | 硬币数 | 需要登录(Cookie) <br />只能查看自己的<br />默认为0 |
| fans_badge | bool | 是否具有粉丝勋章 | false：无<br />true：有 |
| official | obj | 认证信息 | |
| vip | obj | 大会员信息 | |
| vip | obj | 会员信息 | |
| pendant | obj | 头像框信息 | |
| nameplate | obj | 勋章信息 | |
| is_followed | bool | 是否关注此用户 | true：已关注<br />false：未关注<br />需要登录(Cookie) <br />未登录恒为false |
| top_photo | str | 主页头图链接 | |
| theme | obj | 空 | **作用尚不明确** |
| sys_notice | obj | 系统通知 | 无内容则为空 |
| live_room | obj | 直播间信息 | |
`data`中的`official`对象：
@ -70,11 +71,22 @@
`data`中的`vip`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ---------- | ----------------------------------- |
| type | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员 |
| status | num | 大会员状态 | 0：无<br />1：有 |
| theme_type | num | 0 | 作用尚不明确 |
| 字段 | 类型 | 内容 | 备注 |
| ---------------- | ---- | ---------------- | --------------------------------------------- |
| type | num | 会员类型 | 0：无<br />1：月大会员<br />2：年以上的大会员 |
| status | num | 会员状态 | 0：无<br />1：有 |
| theme_type | num | 0 | 作用尚不明确 |
| label | obj | 会员标签 | |
| avatar_subscript | num | 是否显示会员图标 | 0：不显示<br />1：显示 |
| nickname_color | str | 会员昵称颜色 | 颜色码 |
`vip`中的`label`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------- | ------------------------------------------------------------ |
| path | str | 空 | 作用尚不明确 |
| text | str | 会员名称 | |
| label_theme | str | 会员标签 | vip：大会员<br />annual_vip：年度大会员<br />ten_annual_vip：十年大会员<br />hundred_annual_vip：百年大会员 |
`data`中的`pendant`对象：
@ -104,7 +116,21 @@
| content | str | 提示信息 | |
| url | str | 提示信息链接url | |
**示列：**
`data`中的`live_room`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------ |
| roomStatus | num | 直播间状态 | 0：无房间<br />1：有房间 |
| liveStatus | num | 直播状态 | 0：未开播<br />1：直播中 |
| url | str | 直播间网页url | |
| title | str | 直播间标题 | |
| cover | str | 直播间封面url | |
| online | num | 直播间人气 | 值为上次直播时刷新 |
| roomid | num | 直播间ID（短号） | |
| roundStatus | num | 轮播状态 | 0：未轮播<br />1：轮播 |
| broadcast_type | num | 0 | |
**示例：**
查询用户`UID=2`的详细信息
@ -119,53 +145,72 @@ curl -G 'http://api.bilibili.com/x/space/acc/info' \
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 2,
"name": "碧诗",
"sex": "男",
"face": "http://i0.hdslb.com/bfs/app/3e60b20604b6fdc7d081eb6a1ec72aa47c5a3964.jpg",
"sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”",
"rank": 20000,
"level": 6,
"jointime": 0,
"moral": 0,
"silence": 0,
"birthday": "09-19",
"coins": 0,
"fans_badge": true,
"official": {
"role": 2,
"title": "bilibili创始人（站长）",
"desc": "",
"type": 0
},
"vip": {
"type": 2,
"status": 1,
"theme_type": 0
},
"pendant": {
"pid": 76,
"name": "管理员",
"image": "http://i2.hdslb.com/bfs/face/02a3b79edef0f0e682de7f5dca7b6b5fe36d5f65.png",
"expire": 0
},
"nameplate": {
"nid": 10,
"name": "见习偶像",
"image": "http://i1.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
"image_small": "http://i2.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
"level": "普通勋章",
"condition": "所有自制视频总播放数\u003e=10万"
},
"is_followed": true,
"top_photo": "http://i0.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
"theme": {},
"sys_notice": {}
}
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 2,
"name": "碧诗",
"sex": "男",
"face": "http://i0.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”",
"rank": 20000,
"level": 6,
"jointime": 0,
"moral": 0,
"silence": 0,
"birthday": "09-19",
"coins": 0,
"fans_badge": true,
"official": {
"role": 2,
"title": "bilibili创始人（站长）",
"desc": "",
"type": 0
},
"vip": {
"type": 2,
"status": 1,
"theme_type": 0,
"label": {
"path": "",
"text": "十年大会员",
"label_theme": "ten_annual_vip"
},
"avatar_subscript": 1,
"nickname_color": "#FB7299"
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": ""
},
"nameplate": {
"nid": 10,
"name": "见习偶像",
"image": "http://i0.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
"image_small": "http://i0.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
"level": "普通勋章",
"condition": "所有自制视频总播放数>=10万"
},
"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",
"title": "劲夫专业户",
"cover": "http://i0.hdslb.com/bfs/vc/266c730abfe5a4716844b1f4d2e308a0020199ee.jpg",
"online": 16433,
"roomid": 1024,
"roundStatus": 0,
"broadcast_type": 0
}
}
}
```
@ -442,8 +487,6 @@ curl -G 'api.bilibili.com/x/web-interface/card' \
认证方式：Cookie（SESSDATA）
功能同「[登录用户信息1](../login/login_info.md#登录用户信息1（完整）)」
**json回复：**
根对象：
@ -549,68 +592,73 @@ curl -G 'api.bilibili.com/x/space/myinfo' \
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 293793435,
"name": "社会易姐QwQ",
"sex": "男",
"face": "http://i2.hdslb.com/bfs/face/480e2e98513aaeb65d2f2c76dbae750c4de722e9.jpg",
"sign": "咕咕咕咕咕",
"rank": 10000,
"level": 5,
"jointime": 0,
"moral": 70,
"silence": 0,
"email_status": 1,
"tel_status": 1,
"identification": 1,
"vip": {
"type": 2,
"status": 1,
"due_date": 1612454400000,
"vip_pay_type": 1,
"theme_type": 0,
"label": {
"path": ""
}
},
"pendant": {
"pid": 294,
"name": "茶啊二中",
"image": "http://i0.hdslb.com/bfs/face/5bb7bef5107e448892ab54539298d50eb678de05.png",
"expire": 0
},
"nameplate": {
"nid": 0,
"name": "",
"image": "",
"image_small": "",
"level": "",
"condition": ""
},
"official": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"birthday": 1015257600,
"is_tourist": 0,
"is_fake_account": 0,
"pin_prompting": 0,
"is_deleted": 0,
"level_exp": {
"current_level": 5,
"current_min": 10800,
"current_exp": 13985,
"next_exp": 28800
},
"coins": 10.4,
"following": 358,
"follower": 358
}
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 293793435,
"name": "社会易姐QwQ",
"sex": "男",
"face": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
"sign": "高中技术宅一枚，爱好MC&电子&8-bit音乐&数码&编程，粉丝群：1136462265",
"rank": 10000,
"level": 5,
"jointime": 0,
"moral": 70,
"silence": 0,
"email_status": 1,
"tel_status": 1,
"identification": 1,
"vip": {
"type": 2,
"status": 1,
"due_date": 1612454400000,
"vip_pay_type": 1,
"theme_type": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip"
},
"avatar_subscript": 1,
"nickname_color": "#FB7299"
},
"pendant": {
"pid": 2511,
"name": "初音未来13周年",
"image": "http://i0.hdslb.com/bfs/garb/item/4f8f3f1f2d47f0dad84f66aa57acd4409ea46361.png",
"expire": 0,
"image_enhance": "http://i0.hdslb.com/bfs/garb/item/fe0b83b53e2342b16646f6e7a9370d8a867decdb.webp"
},
"nameplate": {
"nid": 4,
"name": "青铜殿堂",
"image": "http://i2.hdslb.com/bfs/face/2879cd5fb8518f7c6da75887994c1b2a7fe670bd.png",
"image_small": "http://i0.hdslb.com/bfs/face/6707c120e00a3445933308fd9b7bd9fad99e9ec4.png",
"level": "普通勋章",
"condition": "单个自制视频总播放数>=1万"
},
"official": {
"role": 0,
"title": "",
"desc": "",
"type": -1
},
"birthday": 1015257600,
"is_tourist": 0,
"is_fake_account": 0,
"pin_prompting": 0,
"is_deleted": 0,
"level_exp": {
"current_level": 5,
"current_min": 10800,
"current_exp": 20528,
"next_exp": 28800
},
"coins": 40.2,
"following": 888,
"follower": 888
}
}
```

426
user/relation.md
View File

@ -3,6 +3,8 @@
- [查询用户粉丝明细](#查询用户粉丝明细)
- [查询用户关注明细](#查询用户关注明细)
- [查询共同关注明细](#查询共同关注明细)
- [查询悄悄关注明细](#查询悄悄关注明细)
- [查询黑名单明细](#查询黑名单明细)
- [操作用户关系（关注/取关 等）](#操作用户关系（关注/取关 等）)
- [批量操作用户关系（仅关注&拉黑）](#批量操作用户关系（仅关注&拉黑）)
- [查询用户与自己关系（仅查关注）](#查询用户与自己关系（仅查关注）)
@ -70,40 +72,40 @@
| n | obj | 粉丝（n+1） | 按照关注顺序排列 |
| …… | obj | …… | …… |
数组`list`中的对象：
`list`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------ | --------------------------------------- |
| mid | num | 用户UID | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 成为粉丝时间 | 时间戳<br />互关后刷新 |
| tag | null | | 作用尚不明确 |
| special | num | 0 | 作用尚不明确 |
| tag | null | | |
| special | num | 0 | |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
数组`list`中的对象中的`official_verify`对象：
`list`中的对象中的`official_verify`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- |
| type | num | 用户认证类型 | -1：无<br />1：认证 |
| desc | str | 用户认证信息 | 无为空 |
数组`list`中的对象中的`vip`对象：
`list`中的对象中的`vip`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------- |
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | 空 | 作用尚不明确 |
| accessStatus | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
| vipStatusWarn | str | 空 | 作用尚不明确 |
| themeType | num | 0 | 作用尚不明确 |
| label | obj | ？？？ | 作用尚不明确 |
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------------------- |
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | 空 | 作用尚不明确 |
| accessStatus | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
| vipStatusWarn | str | 空 | 作用尚不明确 |
| themeType | num | 0 | 作用尚不明确 |
| label | obj | ？？？ | 作用尚不明确 |
`vip`中的`label`对象：
@ -247,7 +249,7 @@ data 对象：
| mid | num | 用户UID | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | 作用尚不明确 |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | |
| special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
@ -263,25 +265,25 @@ data 对象：
| n | num | 位于分组（n+1）的分组ID | |
| …… | num | …… | …… |
数组`list`中的对象中的`official_verify`对象：
`list`中的对象中的`official_verify`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- |
| type | num | 用户认证类型 | -1：无<br />0：认证 |
| type | num | 用户认证类型 | -1：无<br />1：认证 |
| desc | str | 用户认证信息 | 无为空 |
数组`list`中的对象中的`vip`对象：
`list`中的对象中的`vip`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------- |
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | 空 | 作用尚不明确 |
| accessStatus | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
| vipStatusWarn | str | 空 | 作用尚不明确 |
| themeType | num | 0 | 作用尚不明确 |
| label | obj | ？？？ | 作用尚不明确 |
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------------------- |
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | 空 | 作用尚不明确 |
| accessStatus | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
| vipStatusWarn | str | 空 | 作用尚不明确 |
| themeType | num | 0 | 作用尚不明确 |
| label | obj | ？？？ | 作用尚不明确 |
`vip`中的`label`对象：
@ -418,18 +420,18 @@ data 对象：
数组`list`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | --------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户UID | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | 作用尚不明确 |
| special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户UID | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | |
| special | num | 特别关注标志 | 0：否<br />1：是 |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
数组`list`中的对象中的`tag`数组：
@ -439,25 +441,25 @@ data 对象：
| n | num | 位于分组（n+1）的分组ID | |
| …… | num | …… | …… |
数组`list`中的对象中的`official_verify`对象：
`list`中的对象中的`official_verify`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- |
| type | num | 用户认证类型 | -1：无<br />0：认证 |
| type | num | 用户认证类型 | -1：无<br />1：认证 |
| desc | str | 用户认证信息 | 无为空 |
数组`list`中的对象中的`vip`对象：
`list`中的对象中的`vip`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------- |
| vipType | num | 大会员类型 | 0：无<br />1：月会员<br />2：年会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | 空 | 作用尚不明确 |
| accessStatus | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
| vipStatusWarn | str | 空 | 作用尚不明确 |
| themeType | num | 0 | 作用尚不明确 |
| label | obj | ？？？ | 作用尚不明确 |
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------------------- |
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | 空 | 作用尚不明确 |
| accessStatus | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
| vipStatusWarn | str | 空 | 作用尚不明确 |
| themeType | num | 0 | 作用尚不明确 |
| label | obj | ？？？ | 作用尚不明确 |
`vip`中的`label`对象：
@ -550,6 +552,322 @@ curl -G 'http://api.bilibili.com/x/relation/same/followings' \
</details>
## 查询悄悄关注明细
<img src="/imgs/relation.svg" width="100" height="100" />
> http://api.bilibili.com/x/relation/whispers
*请求方式：GET*
认证方式：Cookie（SESSDATA）或APP
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | -------- |
| access_key | str | APP登录Token | APP方式必要 | |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
data 对象：
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ----- | -------- | ------------ |
| list | array | 明细列表 | |
| re_version | num | ？？？ | 作用尚不明确 |
`data`中的`list`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | ---------------- |
| 0 | obj | 关注1 | |
| n | obj | 关注（n+1） | 按照关注顺序排列 |
| …… | obj | …… | …… |
数组`list`中的对象：
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户UID | |
| attribute | num | 关注属性 | 0：未关注<br />2：已关注<br />6：已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | 默认分组：null<br />存在至少一个分组：array | 分组ID | |
| special | num | 特别关注标志 | 0：否<br />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：无<br />1：认证 |
| desc | str | 用户认证信息 | 无为空 |
`list`中的对象中的`vip`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------------------- |
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | 空 | 作用尚不明确 |
| accessStatus | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
| vipStatusWarn | str | 空 | 作用尚不明确 |
| themeType | num | 0 | 作用尚不明确 |
| label | obj | ？？？ | 作用尚不明确 |
`vip`中的`label`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
**示例：**
获取悄悄关注明细
```shell
curl -G 'http://api.bilibili.com/x/relation/whispers' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 178429408,
"attribute": 1,
"mtime": 1605972105,
"tag": null,
"special": 0,
"uname": "老弟一号",
"face": "http://i2.hdslb.com/bfs/face/21426275f3d3149b96b88783275205ba574c09e3.jpg",
"sign": "萌新硬件玩家，前垃圾佬～(◦˙▽˙◦某宝店 老弟一号 粉丝群679540094商务合作V13869651328",
"official_verify": {
"type": 0,
"desc": "知识领域优质UP主"
},
"vip": {
"vipType": 2,
"vipDueDate": 1632499200000,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}
],
"re_version": 2137574562
}
}
```
</details>
## 查询黑名单明细
> http://api.bilibili.com/x/relation/blacks
*请求方式：GET*
认证方式：Cookie（SESSDATA）或APP
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ----------- | -------- |
| access_key | str | APP登录Token | APP方式必要 | |
| ps | num | 每页项数 | 非必要 | 默认为50 |
| pn | num | 页码 | 非必要 | 默认为1 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误 |
| 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 | 关注属性 | 128：已拉黑 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | null | | |
| special | num | 0 | |
| uname | str | 用户昵称 | |
| face | str | 用户头像url | |
| sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | |
`list`中的对象中的`official_verify`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- |
| type | num | 用户认证类型 | -1：无<br />1：认证 |
| desc | str | 用户认证信息 | 无为空 |
`list`中的对象中的`vip`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------------------- |
| vipType | num | 会员类型 | 0：无<br />1：月度大会员<br />2：年度以上大会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | 空 | 作用尚不明确 |
| accessStatus | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0：无<br />1：有 |
| vipStatusWarn | str | 空 | 作用尚不明确 |
| themeType | num | 0 | 作用尚不明确 |
| label | obj | ？？？ | 作用尚不明确 |
`vip`中的`label`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
**示例：**
获取黑名单明细
```shell
curl -G 'http://api.bilibili.com/x/relation/blacks' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"mid": 22179720,
"attribute": 128,
"mtime": 1603032789,
"tag": null,
"special": 0,
"uname": "咩2016",
"face": "http://i0.hdslb.com/bfs/face/41fe435a7e62eae605a5908652f32f3afff2ae74.jpg",
"sign": "",
"official_verify": {
"type": 0,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
},
{
"mid": 16174624,
"attribute": 128,
"mtime": 1603026420,
"tag": null,
"special": 0,
"uname": "其实死亡没有那么痛",
"face": "http://i2.hdslb.com/bfs/face/79257f5a2e7194a71337ccca5927afba7706d316.jpg",
"sign": "等我，我马上就来",
"official_verify": {
"type": 0,
"desc": ""
},
"vip": {
"vipType": 0,
"vipDueDate": 0,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 0,
"vipStatusWarn": "",
"themeType": 0,
"label": {
"path": ""
}
}
}
],
"re_version": 897205356,
"total": 2
}
}
```
</details>
## 操作用户关系（关注/取关 等）
<img src="/imgs/follow.svg" width="200" height="100" />

203
user/space.md
View File

@ -936,17 +936,17 @@ curl 'http://api.bilibili.com/x/space/notice/set' \
`toutu`对象：
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | -------------------- | ------------------------------------------------------ |
| sid | num | 1 | 作用尚不明确 |
| expire | num | 到期时间？ | 时间戳？<br />作用尚不明确 |
| s_img | str | 空间头图小图相对路径 | 完整url为`http://i0.hdslb.com/`+相对路径 |
| l_img | str | 空间头图相对路径 | **同上** |
| android_img | str | 安卓端头图 | 未启用<br />注：手机版头图与web版不同，用另一个api获取 |
| iphone_img | str | iPhone端头图 | 未启用 |
| ipad_img | str | iPad端头图 | 未启用 |
| thumbnail_img | str | 缩略图 | 未启用 |
| platform | num | 0 | 作用尚不明确 |
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | -------------------- | -------------------------------------------------- |
| sid | num | 空间头图ID | |
| expire | num | 到期时间？ | 时间戳？<br />作用尚不明确 |
| s_img | str | 空间头图小图相对路径 | 完整url为`http://i0.hdslb.com/`+相对路径 |
| l_img | str | 空间头图相对路径 | **同上** |
| android_img | str | 空 | 注：**手机端头图与web端不同，需要用另一个api获取** |
| iphone_img | str | 空 | |
| ipad_img | str | 空 | |
| thumbnail_img | str | 缩略图 | |
| platform | num | 0 | 作用尚不明确 |
**示例：**
@ -1551,10 +1551,11 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| list | obj | 列表信息 | |
| page | obj | 页面信息 | |
| 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | -------------- | ---- |
| list | obj | 列表信息 | |
| page | obj | 页面信息 | |
| episodic_button | obj | “播放全部“按钮 | |
`data`中的`list`对象：
@ -1618,6 +1619,13 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \
| pn | num | 当前页码 | |
| ps | num | 每页项数 | |
`data`中的`episodic_button`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---- |
| text | str | 按钮文字 | |
| uri | str | 全部播放页url | |
**示例：**
`pn`（页码）和`ps`（每页项数）只改变`vlist`中成员的多少与内容
@ -1626,6 +1634,7 @@ curl -G 'http://space.bilibili.com/x/space/coin/video' \
```shell
curl -G 'http://api.bilibili.com/x/space/arc/search' \
--data-urlencode 'mid=53456' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1'
```
@ -1635,81 +1644,95 @@ curl -G 'http://api.bilibili.com/x/space/arc/search' \
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": {
"tlist": {
"1": {
"tid": 1,
"count": 17,
"name": "动画"
},
"160": {
"tid": 160,
"count": 43,
"name": "生活"
},
"3": {
"tid": 3,
"count": 33,
"name": "音乐"
},
"4": {
"tid": 4,
"count": 70,
"name": "游戏"
}
},
"vlist": [{
"comment": 4626,
"typeid": 17,
"play": 954380,
"pic": "//i0.hdslb.com/bfs/archive/b40edb19d3000763e1984f854f8f13d2159e13bc.jpg",
"subtitle": "",
"description": "游戏：动物森友会 平台：Switch\n封面画师：微博@HRDrifter \n终于盼来了动森的新作，和大家一起守夜等着游戏解锁，终于能在第一时间和大家一起分享这份喜悦~\n但是为什么这份高兴的心情最后会变成越来越多的房债呢……\n我的微博：@_warma_",
"copyright": "",
"title": "【warma】用水壶往海里浇水海平面会升高吗？《动物森友会》",
"review": 0,
"author": "Warma",
"mid": 53456,
"created": 1585311134,
"length": "48:16",
"video_review": 25064,
"aid": 667551016,
"bvid": "BV1na4y1t7Bf",
"hide_click": false,
"is_pay": 0,
"is_union_video": 0
}, {
"comment": 3372,
"typeid": 17,
"play": 838204,
"pic": "//i1.hdslb.com/bfs/archive/fc2bd95021e5c88a16b16a3bef803e0fc141d059.jpg",
"subtitle": "",
"description": "游戏：Rimworld\n上一期：av96139881\n点赞过8W会更新下一期的~\n录制这一期的时候嗓子炎症加剧了，所以说话有点点闷，不过现在已经好很多了~ 下一期要录的话，我会在嗓子完全康复后再录制的，大家放心~\n我的微博：@_warma_",
"copyright": "",
"title": "【warma实况】拿起狼牙棒去交朋友！《Rimworld》【第二期】",
"review": 0,
"author": "Warma",
"mid": 53456,
"created": 1584758891,
"length": "21:40",
"video_review": 12964,
"aid": 98061972,
"bvid": "BV1vE411c7Wu",
"hide_click": false,
"is_pay": 0,
"is_union_video": 0
}]
},
"page": {
"count": 163,
"pn": 1,
"ps": 2
}
}
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": {
"tlist": {
"1": {
"tid": 1,
"count": 26,
"name": "动画"
},
"160": {
"tid": 160,
"count": 42,
"name": "生活"
},
"211": {
"tid": 211,
"count": 3,
"name": "美食"
},
"3": {
"tid": 3,
"count": 33,
"name": "音乐"
},
"4": {
"tid": 4,
"count": 72,
"name": "游戏"
}
},
"vlist": [
{
"comment": 3558,
"typeid": 47,
"play": 1275661,
"pic": "//i2.hdslb.com/bfs/archive/90157806a34646ac2d4c6af3e8b6156cb3460d14.jpg",
"subtitle": "",
"description": "第一期：BV1ak4y1B7aG\n第二期：BV1eA411Y7FN\n脚本/绘画/配音/动画/片尾曲：warma\n第三期终于做完啦！这是一个以我平时发呆的时候想到的一些灵感组成的冷笑话合集，名字叫《沃玛的生活》，可以当作日常搞笑单元小动画来看。\n如果你喜欢这个系列的话请点赞投币收藏一键三连给我一些继续制作的动力吧，我真的非常非常需要更多的动力！\n祝看得开心~\n我的微博：@_warma_",
"copyright": "",
"title": "【warma】沃玛的新番更新！从现在开始放飞自我【沃玛的生活/第三期】",
"review": 0,
"author": "Warma",
"mid": 53456,
"created": 1605844817,
"length": "05:16",
"video_review": 7470,
"aid": 585275804,
"bvid": "BV1sz4y1y7KJ",
"hide_click": false,
"is_pay": 0,
"is_union_video": 0,
"is_steins_gate": 0
},
{
"comment": 2979,
"typeid": 21,
"play": 840676,
"pic": "//i2.hdslb.com/bfs/archive/b43f88c6ebae8fdc7dfb663f6f6f2931b924c763.jpg",
"subtitle": "",
"description": "前一阵子过生日，大家的礼物经过几番转寄终于收到了~于是录了这期礼物开箱视频。\n现在也在感慨，大家的礼物真的都太强了，居然这些全都是手工做的，真的好厉害！\n这些手工礼物背后得花多少时间和心力啊……这些对我来说都是无价的礼物，制作礼物的大家真的有心了，谢谢！！\n收到这些礼物真的很开心，视频的封面也是在这样激动的情况下画出来的，祝你看得开心~\n我的微博：@_warma_",
"copyright": "",
"title": "【warma】来开箱！大家寄来的生日礼物",
"review": 0,
"author": "Warma",
"mid": 53456,
"created": 1604635221,
"length": "24:28",
"video_review": 10476,
"aid": 287744380,
"bvid": "BV1xf4y1q7XN",
"hide_click": false,
"is_pay": 0,
"is_union_video": 0,
"is_steins_gate": 0
}
]
},
"page": {
"pn": 1,
"ps": 2,
"count": 176
},
"episodic_button": {
"text": "播放全部",
"uri": "//www.bilibili.com/medialist/play/53456?from=space"
}
}
}
```