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

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

View File

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

View File

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

View File

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

View File

@@ -3,6 +3,8 @@
- [查询用户粉丝明细](#查询用户粉丝明细) - [查询用户粉丝明细](#查询用户粉丝明细)
- [查询用户关注明细](#查询用户关注明细) - [查询用户关注明细](#查询用户关注明细)
- [查询共同关注明细](#查询共同关注明细) - [查询共同关注明细](#查询共同关注明细)
- [查询悄悄关注明细](#查询悄悄关注明细)
- [查询黑名单明细](#查询黑名单明细)
- [操作用户关系(关注/取关 等)](#操作用户关系(关注/取关 等)) - [操作用户关系(关注/取关 等)](#操作用户关系(关注/取关 等))
- [批量操作用户关系(仅关注&拉黑)](#批量操作用户关系(仅关注&拉黑)) - [批量操作用户关系(仅关注&拉黑)](#批量操作用户关系(仅关注&拉黑))
- [查询用户与自己关系(仅查关注)](#查询用户与自己关系(仅查关注)) - [查询用户与自己关系(仅查关注)](#查询用户与自己关系(仅查关注))
@@ -70,40 +72,40 @@
| n | obj | 粉丝n+1 | 按照关注顺序排列 | | n | obj | 粉丝n+1 | 按照关注顺序排列 |
| …… | obj | …… | …… | | …… | obj | …… | …… |
数组`list`中的对象: `list`中的对象:
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | ---- | ------------ | --------------------------------------- | | --------------- | ---- | ------------ | --------------------------------------- |
| mid | num | 用户UID | | | mid | num | 用户UID | |
| attribute | num | 关注属性 | 0未关注<br />2已关注<br />6已互粉 | | attribute | num | 关注属性 | 0未关注<br />2已关注<br />6已互粉 |
| mtime | num | 成为粉丝时间 | 时间戳<br />互关后刷新 | | mtime | num | 成为粉丝时间 | 时间戳<br />互关后刷新 |
| tag | null | | 作用尚不明确 | | tag | null | | |
| special | num | 0 | 作用尚不明确 | | special | num | 0 | |
| uname | str | 用户昵称 | | | uname | str | 用户昵称 | |
| face | str | 用户头像url | | | face | str | 用户头像url | |
| sign | str | 用户签名 | | | sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | | | official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | | | vip | obj | 会员信息 | |
数组`list`中的对象中的`official_verify`对象: `list`中的对象中的`official_verify`对象:
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- | | ---- | ---- | ------------ | ------------------- |
| type | num | 用户认证类型 | -1无<br />1认证 | | type | num | 用户认证类型 | -1无<br />1认证 |
| desc | str | 用户认证信息 | 无为空 | | desc | str | 用户认证信息 | 无为空 |
数组`list`中的对象中的`vip`对象: `list`中的对象中的`vip`对象:
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------- | | ------------- | ---- | ------------ | ----------------------------------------------- |
| vipType | num | 会员类型 | 0无<br />1月会员<br />2年会员 | | vipType | num | 会员类型 | 0无<br />1度大会员<br />2度以上大会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | | vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | 空 | 作用尚不明确 | | dueRemark | str | 空 | 作用尚不明确 |
| accessStatus | num | 0 | 作用尚不明确 | | accessStatus | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0无<br />1有 | | vipStatus | num | 大会员状态 | 0无<br />1 |
| vipStatusWarn | str | 空 | 作用尚不明确 | | vipStatusWarn | str | 空 | 作用尚不明确 |
| themeType | num | 0 | 作用尚不明确 | | themeType | num | 0 | 作用尚不明确 |
| label | obj | | 作用尚不明确 | | label | obj | | 作用尚不明确 |
`vip`中的`label`对象: `vip`中的`label`对象:
@@ -247,7 +249,7 @@ data 对象:
| mid | num | 用户UID | | | mid | num | 用户UID | |
| attribute | num | 关注属性 | 0未关注<br />2已关注<br />6已互粉 | | attribute | num | 关注属性 | 0未关注<br />2已关注<br />6已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 | | mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | 作用尚不明确 | | tag | 默认分组null<br />存在至少一个分组array | 分组ID | |
| special | num | 特别关注标志 | 0否<br />1是 | | special | num | 特别关注标志 | 0否<br />1是 |
| uname | str | 用户昵称 | | | uname | str | 用户昵称 | |
| face | str | 用户头像url | | | face | str | 用户头像url | |
@@ -263,25 +265,25 @@ data 对象:
| n | num | 位于分组n+1的分组ID | | | n | num | 位于分组n+1的分组ID | |
| …… | num | …… | …… | | …… | num | …… | …… |
数组`list`中的对象中的`official_verify`对象: `list`中的对象中的`official_verify`对象:
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- | | ---- | ---- | ------------ | ------------------- |
| type | num | 用户认证类型 | -1无<br />0:认证 | | type | num | 用户认证类型 | -1无<br />1:认证 |
| desc | str | 用户认证信息 | 无为空 | | desc | str | 用户认证信息 | 无为空 |
数组`list`中的对象中的`vip`对象: `list`中的对象中的`vip`对象:
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------- | | ------------- | ---- | ------------ | ----------------------------------------------- |
| vipType | num | 会员类型 | 0无<br />1月会员<br />2年会员 | | vipType | num | 会员类型 | 0无<br />1度大会员<br />2度以上大会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | | vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | 空 | 作用尚不明确 | | dueRemark | str | 空 | 作用尚不明确 |
| accessStatus | num | 0 | 作用尚不明确 | | accessStatus | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0无<br />1有 | | vipStatus | num | 大会员状态 | 0无<br />1 |
| vipStatusWarn | str | 空 | 作用尚不明确 | | vipStatusWarn | str | 空 | 作用尚不明确 |
| themeType | num | 0 | 作用尚不明确 | | themeType | num | 0 | 作用尚不明确 |
| label | obj | | 作用尚不明确 | | label | obj | | 作用尚不明确 |
`vip`中的`label`对象: `vip`中的`label`对象:
@@ -418,18 +420,18 @@ data 对象:
数组`list`中的对象: 数组`list`中的对象:
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| --------------- | --------------------------------------- | ------------ | --------------------------------------- | | --------------- | ------------------------------------------- | ------------ | --------------------------------------- |
| mid | num | 用户UID | | | mid | num | 用户UID | |
| attribute | num | 关注属性 | 0未关注<br />2已关注<br />6已互粉 | | attribute | num | 关注属性 | 0未关注<br />2已关注<br />6已互粉 |
| mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 | | mtime | num | 关注对方时间 | 时间戳<br />互关后刷新 |
| tag | null默认分组<br />array存在至少一个分组 | 分组ID | 作用尚不明确 | | tag | 默认分组null<br />存在至少一个分组array | 分组ID | |
| special | num | 特别关注标志 | 0否<br />1是 | | special | num | 特别关注标志 | 0否<br />1是 |
| uname | str | 用户昵称 | | | uname | str | 用户昵称 | |
| face | str | 用户头像url | | | face | str | 用户头像url | |
| sign | str | 用户签名 | | | sign | str | 用户签名 | |
| official_verify | obj | 认证信息 | | | official_verify | obj | 认证信息 | |
| vip | obj | 会员信息 | | | vip | obj | 会员信息 | |
数组`list`中的对象中的`tag`数组: 数组`list`中的对象中的`tag`数组:
@@ -439,25 +441,25 @@ data 对象:
| n | num | 位于分组n+1的分组ID | | | n | num | 位于分组n+1的分组ID | |
| …… | num | …… | …… | | …… | num | …… | …… |
数组`list`中的对象中的`official_verify`对象: `list`中的对象中的`official_verify`对象:
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ------------------- | | ---- | ---- | ------------ | ------------------- |
| type | num | 用户认证类型 | -1无<br />0:认证 | | type | num | 用户认证类型 | -1无<br />1:认证 |
| desc | str | 用户认证信息 | 无为空 | | desc | str | 用户认证信息 | 无为空 |
数组`list`中的对象中的`vip`对象: `list`中的对象中的`vip`对象:
| 字段 | 类型 | 内容 | 备注 | | 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | ----------------------------------- | | ------------- | ---- | ------------ | ----------------------------------------------- |
| vipType | num | 会员类型 | 0无<br />1月会员<br />2年会员 | | vipType | num | 会员类型 | 0无<br />1度大会员<br />2度以上大会员 |
| vipDueDate | num | 会员到期时间 | 时间戳 毫秒 | | vipDueDate | num | 会员到期时间 | 时间戳 毫秒 |
| dueRemark | str | 空 | 作用尚不明确 | | dueRemark | str | 空 | 作用尚不明确 |
| accessStatus | num | 0 | 作用尚不明确 | | accessStatus | num | 0 | 作用尚不明确 |
| vipStatus | num | 大会员状态 | 0无<br />1有 | | vipStatus | num | 大会员状态 | 0无<br />1 |
| vipStatusWarn | str | 空 | 作用尚不明确 | | vipStatusWarn | str | 空 | 作用尚不明确 |
| themeType | num | 0 | 作用尚不明确 | | themeType | num | 0 | 作用尚不明确 |
| label | obj | | 作用尚不明确 | | label | obj | | 作用尚不明确 |
`vip`中的`label`对象: `vip`中的`label`对象:
@@ -550,6 +552,322 @@ curl -G 'http://api.bilibili.com/x/relation/same/followings' \
</details> </details>
## 查询悄悄关注明细
<img src="/imgs/relation.svg" width="100" height="100" />
> http://api.bilibili.com/x/relation/whispers
*请求方式GET*
认证方式CookieSESSDATA或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*
认证方式CookieSESSDATA或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" /> <img src="/imgs/follow.svg" width="200" height="100" />

View File

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