添加【视频在线人数】api,更新视频分区信息,并勘误

This commit is contained in:
社会易姐QwQ
2021-08-20 19:54:13 +08:00
parent d0797241a5
commit 494f5a4735
10 changed files with 605 additions and 386 deletions

View File

@@ -2,19 +2,19 @@
<img src="/imgs/akari.jpg" width="200" height="200"/>
- [用户详细信息1 (用于空间)](#用户详细信息1 (用于空间))
- [用户详细信息2 (用于名片)](#用户详细信息2 (用于名片))
- [本用户详细信息](#本用户详细信息)
- [用户空间详细信息 ](#用户空间详细信息)
- [用户名片信息](#用户名片信息)
- [登录用户空间详细信息](#登录用户空间详细信息)
---
## 用户详细信息1 (用于空间)
## 用户空间详细信息
> http://api.bilibili.com/x/space/acc/info
*请求方式GET*
认证方式CookieSESSDATA
认证方式Cookie(SESSDATA)
**url参数**
@@ -35,39 +35,45 @@
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | ------------------------------------------------------------ |
| mid | num | mid | |
| name | str | 昵称 | |
| sex | str | 性别 | 男/女/保密 |
| face | str | 头像链接 | |
| sign | str | 签名 | |
| rank | num | 10000 | |
| level | num | 当前等级 | 0-6级 |
| jointime | num | 0 | |
| moral | num | 0 | |
| silence | num | 封禁状态 | 0正常<br />1被封 |
| birthday | str | 生日 | MM-DD<br />如设置隐私为空 |
| coins | num | 硬币数 | 需要登录(Cookie) <br />只能查看自己的<br />默认为0 |
| fans_badge | bool | 是否具有粉丝勋章 | false<br />true |
| official | 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 | 系统通知 | 无内容则为空对象<br />主要用于展示如用户争议、纪念账号等等 |
| live_room | obj | 直播间信息 | |
| 字段 | 类型 | 内容 | 备注 |
| ---------------- | ---- | ---------------- | ------------------------------------------------------------ |
| mid | num | mid | |
| name | str | 昵称 | |
| sex | str | 性别 | 男/女/保密 |
| face | str | 头像链接 | |
| sign | str | 签名 | |
| rank | num | 10000 | |
| level | num | 当前等级 | 0-6级 |
| jointime | num | 0 | |
| moral | num | 0 | |
| silence | num | 封禁状态 | 0正常<br />1被封 |
| coins | num | 硬币数 | 需要登录(Cookie) <br />只能查看自己的<br />默认为0 |
| fans_badge | bool | 是否具有粉丝勋章 | false<br />true |
| fans_medal | obj | | |
| official | obj | 认证信息 | |
| vip | obj | 会员信息 | |
| pendant | obj | 头像框信息 | |
| nameplate | obj | 勋章信息 | |
| user_honour_info | obj | | |
| is_followed | bool | 是否关注此用户 | true已关注<br />false未关注<br />需要登录(Cookie) <br />未登录恒为false |
| top_photo | str | 主页头图链接 | |
| theme | obj | | **作用尚不明确** |
| sys_notice | obj | 系统通知 | 无内容则为空对象<br />主要用于展示如用户争议、纪念账号等等 |
| live_room | obj | 直播间信息 | |
| birthday | str | 生日 | MM-DD<br />如设置隐私为空 |
| school | obj | | |
| profession | obj | | |
| tags | null | | |
| series | obj | | |
`data`中的`official`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------- | ----------------------------------------------- |
| role | num | 认证类型 | 0<br />1 2个人认证<br />3 4 5 6机构认证 |
| title | str | 认证信息 | 无为空 |
| desc | str | 认证备注 | 无为空 |
| type | num | 是否认证 | -1<br />0认证 |
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------- | ------------------------------------------------- |
| role | num | 认证类型 | 0<br />1 2 7:个人认证<br />3 4 5 6机构认证 |
| title | str | 认证信息 | 无为空 |
| desc | str | 认证备注 | 无为空 |
| type | num | 是否认证 | -1<br />0认证 |
`data`中的`vip`对象:
@@ -123,17 +129,17 @@
`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 | |
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | -------------- | ------------------------ |
| 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 | |
**示例:**
@@ -157,16 +163,37 @@ curl -G 'http://api.bilibili.com/x/space/acc/info' \
"mid": 2,
"name": "碧诗",
"sex": "男",
"face": "http://i0.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"face": "http://i2.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,
"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创始人站长",
@@ -176,44 +203,70 @@ curl -G 'http://api.bilibili.com/x/space/acc/info' \
"vip": {
"type": 2,
"status": 1,
"due_date": 3896524800000,
"vip_pay_type": 0,
"theme_type": 0,
"label": {
"path": "",
"text": "十年大会员",
"label_theme": "ten_annual_vip"
"label_theme": "ten_annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"nickname_color": "#FB7299"
"nickname_color": "#FB7299",
"role": 7,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png"
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": ""
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 10,
"name": "见习偶像",
"image": "http://i0.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
"image_small": "http://i0.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
"image_small": "http://i1.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
"level": "普通勋章",
"condition": "所有自制视频总播放数>=10万"
"condition": "所有自制视频总播放数\u003e=10万"
},
"user_honour_info": {
"mid": 0,
"colour": null,
"tags": null
},
"is_followed": true,
"top_photo": "http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png",
"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",
"title": "劲夫专业户",
"cover": "http://i0.hdslb.com/bfs/vc/266c730abfe5a4716844b1f4d2e308a0020199ee.jpg",
"online": 16433,
"title": "试图恰鸡",
"cover": "http://i0.hdslb.com/bfs/live/new_room_cover/96ee5bfd0279a0f18b190340334f43f473038288.jpg",
"online": 16808,
"roomid": 1024,
"roundStatus": 0,
"broadcast_type": 0
},
"birthday": "09-19",
"school": {
"name": ""
},
"profession": {
"name": ""
},
"tags": null,
"series": {
"user_upgrade_status": 1,
"show_upgrade_window": false
}
}
}
@@ -241,7 +294,7 @@ http://i1.hdslb.com/bfs/face/3e60b20604b6fdc7d081eb6a1ec72aa47c5a3964.jpg
**认证**:个人认证
**认证名称** bilibili创始人站长
**认证名称** bilibili创始人(站长)
**大会员类型**:年度
@@ -267,13 +320,13 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
## 用户详细信息2 (用于名片)
## 用户名片信息
> http://api.bilibili.com/x/web-interface/card
*请求方式GET*
认证方式CookieSESSDATA
认证方式Cookie(SESSDATA)
**url参数**
@@ -362,12 +415,12 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
`card`中的`Official`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------- | ----------------------------------------------- |
| role | num | 认证类型 | 0<br />1 2个人认证<br />3 4 5 6机构认证 |
| title | str | 认证信息 | 无为空 |
| desc | str | 认证备注 | 无为空 |
| type | num | 是否认证 | -1<br />0认证 |
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------- | ------------------------------------------------- |
| role | num | 认证类型 | 0<br />1 2 7:个人认证<br />3 4 5 6机构认证 |
| title | str | 认证信息 | 无为空 |
| desc | str | 认证备注 | 无为空 |
| type | num | 是否认证 | -1<br />0认证 |
`card`中的`official_verify`对象:
@@ -408,89 +461,105 @@ curl -G 'api.bilibili.com/x/web-interface/card' \
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"card": {
"mid": "2",
"name": "碧诗",
"approve": false,
"sex": "男",
"rank": "20000",
"face": "http://i1.hdslb.com/bfs/face/3e60b20604b6fdc7d081eb6a1ec72aa47c5a3964.jpg",
"DisplayRank": "0",
"regtime": 0,
"spacesta": 0,
"birthday": "",
"place": "",
"description": "",
"article": 0,
"attentions": [],
"fans": 810968,
"friend": 192,
"attention": 192,
"sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”",
"level_info": {
"current_level": 6,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 76,
"name": "管理员",
"image": "http://i2.hdslb.com/bfs/face/02a3b79edef0f0e682de7f5dca7b6b5fe36d5f65.png",
"expire": 0
},
"nameplate": {
"nid": 10,
"name": "见习偶像",
"image": "http://i0.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
"image_small": "http://i1.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
"level": "普通勋章",
"condition": "所有自制视频总播放数\u003e=10万"
},
"Official": {
"role": 2,
"title": "bilibili创始人站长",
"desc": "",
"type": 0
},
"official_verify": {
"type": 0,
"desc": "bilibili创始人站长"
},
"vip": {
"vipType": 2,
"dueRemark": "",
"accessStatus": 0,
"vipStatus": 1,
"vipStatusWarn": "",
"theme_type": 0
}
},
"space": {
"s_img": "http://i2.hdslb.com/bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png",
"l_img": "http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png"
},
"following": true,
"archive_count": 35,
"article_count": 0,
"follower": 810968
}
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"card": {
"mid": "2",
"name": "碧诗",
"approve": false,
"sex": "男",
"rank": "20000",
"face": "http://i2.hdslb.com/bfs/face/ef0457addb24141e15dfac6fbf45293ccf1e32ab.jpg",
"DisplayRank": "0",
"regtime": 0,
"spacesta": 0,
"birthday": "",
"place": "",
"description": "",
"article": 0,
"attentions": [],
"fans": 969999,
"friend": 234,
"attention": 234,
"sign": "kami.im 直男过气网红 # av362830 “We Are Star Dust”",
"level_info": {
"current_level": 6,
"current_min": 0,
"current_exp": 0,
"next_exp": 0
},
"pendant": {
"pid": 0,
"name": "",
"image": "",
"expire": 0,
"image_enhance": "",
"image_enhance_frame": ""
},
"nameplate": {
"nid": 10,
"name": "见习偶像",
"image": "http://i2.hdslb.com/bfs/face/e93dd9edfa7b9e18bf46fd8d71862327a2350923.png",
"image_small": "http://i2.hdslb.com/bfs/face/275b468b043ec246737ab8580a2075bee0b1263b.png",
"level": "普通勋章",
"condition": "所有自制视频总播放数\u003e=10万"
},
"Official": {
"role": 2,
"title": "bilibili创始人站长",
"desc": "",
"type": 0
},
"official_verify": {
"type": 0,
"desc": "bilibili创始人站长"
},
"vip": {
"type": 2,
"status": 1,
"due_date": 3896524800000,
"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": ""
},
"avatar_subscript": 1,
"nickname_color": "#FB7299",
"role": 7,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png",
"vipType": 2,
"vipStatus": 1
}
},
"space": {
"s_img": "http://i1.hdslb.com/bfs/space/768cc4fd97618cf589d23c2711a1d1a729f42235.png",
"l_img": "http://i1.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png"
},
"following": true,
"archive_count": 37,
"article_count": 0,
"follower": 969999
}
}
```
</details>
## 本用户详细信息
## 登录用户空间详细信息
> http://api.bilibili.com/x/space/myinfo
*请求方式GET*
认证方式CookieSESSDATA
认证方式Cookie(SESSDATA)
**json回复**
@@ -572,12 +641,12 @@ curl -G 'api.bilibili.com/x/web-interface/card' \
`data`中的`Official`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------- | ----------------------------------------------- |
| role | num | 认证类型 | 0<br />1 2个人认证<br />3 4 5 6机构认证 |
| title | str | 认证信息 | 无为空 |
| desc | str | 认证备注 | 无为空 |
| type | num | 是否认证 | -1<br />0认证 |
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------- | ------------------------------------------------- |
| role | num | 认证类型 | 0<br />1 2 7:个人认证<br />3 4 5 6机构认证 |
| title | str | 认证信息 | 无为空 |
| desc | str | 认证备注 | 无为空 |
| type | num | 是否认证 | -1<br />0认证 |
`data`中的`level_exp`对象:
@@ -608,7 +677,7 @@ curl -G 'api.bilibili.com/x/space/myinfo' \
"name": "社会易姐QwQ",
"sex": "男",
"face": "http://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
"sign": "高中技术宅一枚爱好MC&电子&8-bit音乐&数码&编程,粉丝群1136462265",
"sign": "高考刚结束的普通技术宅一枚喜欢MC和编程以及电子是车车人也是术术人,粉丝群:1136462265",
"rank": 10000,
"level": 5,
"jointime": 0,
@@ -620,31 +689,38 @@ curl -G 'api.bilibili.com/x/space/myinfo' \
"vip": {
"type": 2,
"status": 1,
"due_date": 1612454400000,
"vip_pay_type": 1,
"due_date": 1644163200000,
"vip_pay_type": 0,
"theme_type": 0,
"label": {
"path": "",
"text": "年度大会员",
"label_theme": "annual_vip"
"label_theme": "annual_vip",
"text_color": "#FFFFFF",
"bg_style": 1,
"bg_color": "#FB7299",
"border_color": ""
},
"avatar_subscript": 1,
"nickname_color": "#FB7299"
"nickname_color": "#FB7299",
"role": 3,
"avatar_subscript_url": "http://i0.hdslb.com/bfs/vip/icon_Certification_big_member_22_3x.png"
},
"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"
"image_enhance": "http://i0.hdslb.com/bfs/garb/item/fe0b83b53e2342b16646f6e7a9370d8a867decdb.webp",
"image_enhance_frame": "http://i0.hdslb.com/bfs/garb/item/127c507ec8448be30cf5f79500ecc6ef2fd32f2c.png"
},
"nameplate": {
"nid": 4,
"name": "青铜殿堂",
"image": "http://i2.hdslb.com/bfs/face/2879cd5fb8518f7c6da75887994c1b2a7fe670bd.png",
"image": "http://i0.hdslb.com/bfs/face/2879cd5fb8518f7c6da75887994c1b2a7fe670bd.png",
"image_small": "http://i0.hdslb.com/bfs/face/6707c120e00a3445933308fd9b7bd9fad99e9ec4.png",
"level": "普通勋章",
"condition": "单个自制视频总播放数>=1万"
"condition": "单个自制视频总播放数\u003e=1万"
},
"official": {
"role": 0,
@@ -657,15 +733,22 @@ curl -G 'api.bilibili.com/x/space/myinfo' \
"is_fake_account": 0,
"pin_prompting": 0,
"is_deleted": 0,
"in_reg_audit": 0,
"is_rip_user": false,
"profession": {
"id": 0,
"name": "",
"show_name": ""
},
"level_exp": {
"current_level": 5,
"current_min": 10800,
"current_exp": 20528,
"current_exp": 27125,
"next_exp": 28800
},
"coins": 40.2,
"following": 888,
"follower": 888
"coins": 9,
"following": 1122,
"follower": 1122
}
}
```

View File

@@ -6,10 +6,10 @@
- [查询共同关注明细](#查询共同关注明细)
- [查询悄悄关注明细](#查询悄悄关注明细)
- [查询黑名单明细](#查询黑名单明细)
- [操作用户关系(关注/取关 等)](#操作用户关系(关注/取关 等))
- [批量操作用户关系(仅关注&拉黑)](#批量操作用户关系(仅关注&拉黑))
- [查询用户与自己关系仅查关注](#查询用户与自己关系仅查关注)
- [查询用户与自己关系互相](#查询用户与自己关系互相)
- [操作用户关系](#操作用户关系)
- [批量操作用户关系](#批量操作用户关系)
- [查询用户与自己关系_仅查关注](#查询用户与自己关系_仅查关注)
- [查询用户与自己关系_互相](#查询用户与自己关系_互相)
- [批量查询用户与自己关系](#批量查询用户与自己关系)
- [关注分组相关](#关注分组相关)
- [查询关注分组列表](#查询关注分组列表)
@@ -19,7 +19,7 @@
- [创建分组](#创建分组)
- [重命名分组](#重命名分组)
- [删除分组](#删除分组)
- [修改分组成员(添加/删除)](#修改分组成员(添加/删除))
- [修改分组成员](#修改分组成员)
- [复制关注到分组](#复制关注到分组)
- [移动关注到分组](#移动关注到分组)
@@ -33,7 +33,7 @@
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
登录可看自己前1000名其他用户仅可查看前100名
@@ -67,11 +67,11 @@
`data`中的`list`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | ---------------- |
| 0 | obj | 粉丝1 | |
| n | obj | 粉丝n+1 | 按照关注顺序排列 |
| …… | obj | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 粉丝1 | |
| n | obj | 粉丝(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
`list`中的对象:
@@ -202,7 +202,7 @@ curl -G 'http://api.bilibili.com/x/relation/followers' \
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
登录可看自己全部其他用户仅可查看前5页
@@ -237,11 +237,11 @@ data 对象:
`data`中的`list`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | ---------------- |
| 0 | obj | 关注1 | |
| n | obj | 关注n+1 | 按照关注顺序排列 |
| …… | obj | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 关注1 | |
| n | obj | 关注(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
数组`list`中的对象:
@@ -260,11 +260,11 @@ data 对象:
数组`list`中的对象中的`tag`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组n+1的分组id | |
| …… | num | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组(n+1)的分组id | |
| …… | num | …… | …… |
`list`中的对象中的`official_verify`对象:
@@ -381,7 +381,7 @@ curl -G 'http://api.bilibili.com/x/relation/ollowings' \
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**url参数**
@@ -403,11 +403,11 @@ data 对象:
`data`中的`list`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | ---------------- |
| 0 | obj | 共同关注1 | |
| n | obj | 共同关注n+1 | 按照关注顺序排列 |
| …… | obj | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---------------- |
| 0 | obj | 共同关注1 | |
| n | obj | 共同关注(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
数组`list`中的对象:
@@ -426,11 +426,11 @@ data 对象:
数组`list`中的对象中的`tag`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组n+1的分组id | |
| …… | num | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组(n+1)的分组id | |
| …… | num | …… | …… |
`list`中的对象中的`official_verify`对象:
@@ -526,7 +526,7 @@ curl -G 'http://api.bilibili.com/x/relation/followings/search' \
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**url参数**
@@ -558,11 +558,11 @@ data 对象:
`data`中的`list`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | ---------------- |
| 0 | obj | 共同关注1 | |
| n | obj | 共同关注n+1 | 按照关注顺序排列 |
| …… | obj | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---------------- |
| 0 | obj | 共同关注1 | |
| n | obj | 共同关注(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
数组`list`中的对象:
@@ -581,11 +581,11 @@ data 对象:
数组`list`中的对象中的`tag`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组n+1的分组id | |
| …… | num | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组(n+1)的分组id | |
| …… | num | …… | …… |
`list`中的对象中的`official_verify`对象:
@@ -706,7 +706,7 @@ curl -G 'http://api.bilibili.com/x/relation/same/followings' \
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**url参数**
@@ -736,11 +736,11 @@ data 对象:
`data`中的`list`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | ---------------- |
| 0 | obj | 关注1 | |
| n | obj | 关注n+1 | 按照关注顺序排列 |
| …… | obj | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 关注1 | |
| n | obj | 关注(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
数组`list`中的对象:
@@ -759,11 +759,11 @@ data 对象:
数组`list`中的对象中的`tag`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组n+1的分组id | |
| …… | num | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组(n+1)的分组id | |
| …… | num | …… | …… |
`list`中的对象中的`official_verify`对象:
@@ -853,7 +853,7 @@ curl -G 'http://api.bilibili.com/x/relation/whispers' \
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**url参数**
@@ -884,11 +884,11 @@ data 对象:
`data`中的`list`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | ---------------- |
| 0 | obj | 关注1 | |
| n | obj | 关注n+1 | 按照关注顺序排列 |
| …… | obj | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | ---------------- |
| 0 | obj | 关注1 | |
| n | obj | 关注(n+1) | 按照关注顺序排列 |
| …… | obj | …… | …… |
数组`list`中的对象:
@@ -1014,7 +1014,7 @@ curl -G 'http://api.bilibili.com/x/relation/blacks' \
</details>
## 操作用户关系(关注/取关 等)
## 操作用户关系
<img src="/imgs/follow.svg" width="200" height="100" />
@@ -1022,17 +1022,17 @@ curl -G 'http://api.bilibili.com/x/relation/blacks' \
*请求方式POST*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**正文参数 application/x-www-form-urlencoded **
**正文参数( application/x-www-form-urlencoded )**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | -------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fid | num | 目标用户mid | 必要 | |
| act | num | 操作代码 | 必要 | **操作代码见下表** |
| re_src | num | 关注来源代码 | 必要 | 空间11<br />视频14<br />文章115<br />活动页面222 |
| csrf | str | CSRF Token位于cookie | Cookie方式必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ---------------------- | -------------- | -------------------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fid | num | 目标用户mid | 必要 | |
| act | num | 操作代码 | 必要 | **操作代码见下表** |
| re_src | num | 关注来源代码 | 必要 | 空间11<br />视频14<br />文章115<br />活动页面222 |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
操作代码`act`
@@ -1082,23 +1082,25 @@ curl 'http://api.bilibili.com/x/relation/modify' \
</details>
## 批量操作用户关系(仅关注&拉黑)
## 批量操作用户关系
> http://api.bilibili.com/x/relation/batch/modify
*请求方式POST*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**正文参数( application/x-www-form-urlencoded **
此接口只支持关注和拉黑操作
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ---------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
| act | num | 操作代码 | 必要 | 同上<br />仅可为1或5故只能进行批量关注和拉黑 |
| re_src | num | 关注来源代码 | 必要 | 同上 |
| csrf | str | CSRF Token位于cookie | Cookie方式必要 | |
**正文参数( application/x-www-form-urlencoded )**
| 参数名 | 类型 | 内容 | 必要 | 备注 |
| ---------- | ---- | ---------------------- | -------------- | ---------------------------------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
| act | num | 操作代码 | 必要 | 同上<br />仅可为1或5故只能进行批量关注和拉黑 |
| re_src | num | 关注来源代码 | 必要 | 同上 |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
**json回复**
@@ -1119,11 +1121,11 @@ curl 'http://api.bilibili.com/x/relation/modify' \
`data`中的`failed_fids`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------------- | ---- |
| 0 | num | 操作失败的mid 1 | |
| n | num | 操作失败的midn+1 | |
| …… | num | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------ | ---- |
| 0 | num | 操作失败的mid 1 | |
| n | num | 操作失败的mid(n+1) | |
| …… | num | …… | …… |
**示例:**
@@ -1153,13 +1155,13 @@ curl 'http://http://api.bilibili.com/x/relation/batch/modify' \
</details>
## 查询用户与自己关系仅查关注
## 查询用户与自己关系_仅查关注
> http://api.bilibili.com/x/relation
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**url参数**
@@ -1194,7 +1196,7 @@ curl 'http://http://api.bilibili.com/x/relation/batch/modify' \
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组 | |
| n | num | 位于分组n+1的分组 | |
| n | num | 位于分组(n+1)的分组 | |
| …… | num | …… | …… |
**示例:**
@@ -1227,13 +1229,13 @@ curl -G 'http://http://api.bilibili.com/x/relation' \
</details>
## 查询用户与自己关系互相
## 查询用户与自己关系_互相
> http://api.bilibili.com/x/space/acc/relation
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**url参数**
@@ -1282,15 +1284,15 @@ curl -G 'http://http://api.bilibili.com/x/relation' \
`be_relation``relation`中的`tag`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组n+1的分组id | |
| …… | num | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组(n+1)的分组id | |
| …… | num | …… | …… |
**示例:**
可得对于`mid=15858903`的用户,在`2019/1/24 14:24:19`时关注了对方,且互相关注,自己将对方特别关注,并同时位于为`-10``194110`的分组中,对方也将自己设为特别关注,并同时位于为`-10``56502`的分组中虽然我看不到
可得对于`mid=15858903`的用户,在`2019/1/24 14:24:19`时关注了对方,且互相关注,自己将对方特别关注,并同时位于为`-10``194110`的分组中,对方也将自己设为特别关注,并同时位于为`-10``56502`的分组中(虽然我看不到)
```shell
curl -G 'http://api.bilibili.com/x/space/acc/relation' \
@@ -1335,7 +1337,7 @@ curl -G 'http://api.bilibili.com/x/space/acc/relation' \
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**url参数**
@@ -1374,11 +1376,11 @@ curl -G 'http://api.bilibili.com/x/space/acc/relation' \
`tag`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组n+1的分组id | |
| …… | num | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------------- | ---- |
| 0 | num | 位于分组1的分组id | |
| n | num | 位于分组(n+1)的分组id | |
| …… | num | …… | …… |
**示例:**
@@ -1427,7 +1429,7 @@ curl -G 'http://http://api.bilibili.com/x/relation/relations' \
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**url参数**
@@ -1506,7 +1508,7 @@ curl 'http://api.bilibili.com/x/relation/tags' \
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**url参数**
@@ -1531,11 +1533,11 @@ curl 'http://api.bilibili.com/x/relation/tags' \
`data`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | ---------------- |
| 0 | obj | 成员信息1 | |
| n | obj | 成员信息n+1 | 按照添加顺序排序 |
| …… | obj | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------- | ---------------- |
| 0 | obj | 成员信息1 | |
| n | obj | 成员信息(n+1) | 按照添加顺序排序 |
| …… | obj | …… | …… |
数组`data`中的对象:
@@ -1649,7 +1651,7 @@ curl -G 'http://api.bilibili.com/x/relation/tag' \
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**url参数**
@@ -1710,7 +1712,7 @@ curl -G 'http://api.bilibili.com/x/relation/tag/user' \
*请求方式GET*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**url参数**
@@ -1731,11 +1733,11 @@ curl -G 'http://api.bilibili.com/x/relation/tag/user' \
`data`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------- | ---- |
| 0 | num | 成员1mid | |
| n | num | 成员n+1mid | |
| …… | num | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------ | ---- |
| 0 | num | 成员1mid | |
| n | num | 成员(n+1)mid | |
| …… | num | …… | …… |
**示例:**
@@ -1785,15 +1787,15 @@ curl 'http://api.bilibili.com/x/relation/tag/special' \
*请求方式POST*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**正文参数 application/x-www-form-urlencoded **
**正文参数( application/x-www-form-urlencoded )**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ---------- |
| access_key | str | APP登录Token | APP方式必要 | |
| tag | str | 分组名 | 必要 | 最长16字符 |
| csrf | str | CSRF Token位于cookie | Cookie方式必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ---------------------- | -------------- | ---------- |
| access_key | str | APP登录Token | APP方式必要 | |
| tag | str | 分组名 | 必要 | 最长16字符 |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
**json回复**
@@ -1845,16 +1847,16 @@ curl 'http://api.bilibili.com/x/relation/tag/create' \
*请求方式POST*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**正文参数 application/x-www-form-urlencoded **
**正文参数( application/x-www-form-urlencoded )**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ---------- |
| access_key | str | APP登录Token | APP方式必要 | |
| tagid | num | 分组id | 必要 | |
| name | str | 新名称 | 必要 | 最长16字符 |
| csrf | str | CSRF Token位于cookie | Cookie方式必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ---------------------- | -------------- | ---------- |
| access_key | str | APP登录Token | APP方式必要 | |
| tagid | num | 分组id | 必要 | |
| name | str | 新名称 | 必要 | 最长16字符 |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
**json回复**
@@ -1899,15 +1901,15 @@ curl 'http://api.bilibili.com/x/relation/tag/update' \
*请求方式POST*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**正文参数 application/x-www-form-urlencoded **
**正文参数( application/x-www-form-urlencoded )**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| tagid | num | 分组id | 必要 | |
| csrf | str | CSRF Token位于cookie | Cookie方式必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ---------------------- | -------------- | ---- |
| access_key | str | APP登录Token | APP方式必要 | |
| tagid | num | 分组id | 必要 | |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
**json回复**
@@ -1943,7 +1945,7 @@ curl 'http://api.bilibili.com/x/relation/tag/del' \
</details>
### 修改分组成员(添加/删除)
### 修改分组成员
<img src="/imgs/add.svg" width="100" height="100" />
@@ -1951,16 +1953,18 @@ curl 'http://api.bilibili.com/x/relation/tag/del' \
*请求方式POST*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**正文参数( application/x-www-form-urlencoded **
如需删除分组中的成员,请将`tagids`设为0即移动至默认分组而不是取关
**正文参数( application/x-www-form-urlencoded )**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 目标用户mid | 必要 | 每个之间用`,`间隔 |
| tagids | nums | 分组id | 必要 | 每个之间用`,`间隔 |
| csrf | str | CSRF Token位于cookie | Cookie方式必要 | |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
**json回复**
@@ -2003,16 +2007,16 @@ curl 'http://api.bilibili.com/x/relation/tags/addUsers' \
*请求方式POST*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**正文参数 application/x-www-form-urlencoded **
**正文参数( application/x-www-form-urlencoded )**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------------------ | -------------- | ------------------- |
| access_key | str | APP登录Token | APP方式必要 | |
| fids | nums | 待复制的用户mid | 必要 | 每个之间用`,`间隔 |
| tagids | nums | 目标分组id | 必要 | 每个之间用`,`间隔 |
| csrf | str | CSRF Token位于cookie | Cookie方式必要 | |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
**json回复**
@@ -2055,9 +2059,9 @@ curl 'http://api.bilibili.com/x/relation/tags/copyUsers' \
*请求方式POST*
认证方式CookieSESSDATA或APP
认证方式Cookie(SESSDATA)或APP
**正文参数 application/x-www-form-urlencoded **
**正文参数( application/x-www-form-urlencoded )**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ------------------------ | -------------- | ------------------- |
@@ -2065,7 +2069,7 @@ curl 'http://api.bilibili.com/x/relation/tags/copyUsers' \
| beforeTagids | nums | 原分组id | 必要 | 每个之间用`,`间隔 |
| afterTagids | nums | 新分组id | 必要 | 每个之间用`,`间隔 |
| fids | nums | 待移动的用户mid | 必要 | 每个之间用`,`间隔 |
| csrf | str | CSRF Token位于cookie | Cookie方式必要 | |
| csrf | str | CSRF Token(位于cookie) | Cookie方式必要 | |
**json回复**