feat: 各种接口补充与错误修正 (#1066)

* fix(video/collection.md): unclosed xml tags

* feat(video/report.md): uuid not really random

* feat: b23.tv short link

* feat: login/moral/exp log

* feat: v_voucher

* feat: upload video cover & post

* feat(creativecenter/upload.md): upload octet-stream

* feat(creativecenter/upload.md): update some notes

* feat(clientinfo/ip.md): another from live

* feat: live web heartbeat

* feat: update popular series & precious

* fix(creativecenter/upload.md): mistakes in example

* feat: merge duplicate fav info

* feat(README.md): missing link to webmask

* feat(search/hot.md): word_type

* feat(login/login_action): recovery old api

* feat(video/collection.md):  series operation

* feat: video season operation

* feat: add & mod some links

* feat(search/suggest.md): up to date

* feat: web home header image

* feat(misc/sign/bili_ticket.md): demo for nodejs

* feat(creativecenter/upload.md): x-upos-auth validity period

* feat: add referer & buvid3 to request header

* feat: customer service message heartbeat & upload

* feat(customerservice/msg.md): upload code 1200201

* feat(video/report.md): click/web/h5

* feat(video/report.md): view count desc

* feat: laser2

* feat: wbi_key in bili_ticket

* fix: typo & unclosed XML tags

* feat(misc/sign/v_voucher): cookie x-bili-gaia-vtoken

* feat(search/hot.md): square

* feat(video/status_number.md): fold archive_stat/stat

* feat(fav/info.md): resource/infos invalid type 21

* feat: /x/activity/subject/info

* feat: lottery

* feat(docs/misc/b23.tv): remove some unnecessary fields

* feat(creativecenter/upload.md): types/predict

* fix(video/collection.md): invalid end tag

* feat: app version upgrade

* feat(creativecenter/upload.md): tag/recommend #528

* feat(user/status_number.md): navnum

* feat: /x/activity/page/list

* feat(comment/list.md): desc about pagination_str

* feat(comment/list.md): update example

* feat(dynamic/all.md): #1082

* fix(comment/list.md): -352 not -412

* feat: #700

* feat(video/video_stream.md): #606 & cv949156

* feat(message/private_msg.md): single_unread freq

* feat: getUserWallet

* fix: broken form

* feat(Layout.vue): copyright to 2024

* feat: /x/topic/pub/rcmd/search

* feat: #425

* feat(misc/time_stamp.md): rtc/getTimestamp

* fix(misc/time_stamp.md): missing end tag

* feat: #745

* feat(dynamic/all.md): update feed/all

* feat(danmaku/action.md): #220

* feat(live/info.md): gethistory from cv8186413

* fix(danmaku/action.md): missing end tag
This commit is contained in:
Session小胡
2024-08-21 19:02:39 +08:00
committed by GitHub
parent f7599fb693
commit 60a0c5d1a2
46 changed files with 18489 additions and 8207 deletions

822
docs/user/medals.md Normal file
View File

@@ -0,0 +1,822 @@
# 所有粉丝勋章
## 指定用户的所有粉丝勋章信息
> https://api.live.bilibili.com/xlive/web-ucenter/user/MedalWall
*请求方法: GET*
认证方式: Cookie (SESSDATA)
<!--{
"gh": [425]
}-->
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | -------- | ------ | ---- |
| target_id | num | 目标 mid | 必要 | |
**JSON回复:**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------- |
| code | num | 返回值 | 0: 成功<br />-101: 账号未登录 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 数据本体 | 失败时不存在 |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ----- | --------------------- | ----- |
| list | array | 勋章列表 | |
| count | num | 勋章数 | |
| close_space_medal | num | 关闭空间粉丝勋章显示? | 0: 否 |
| only_show_wearing | num | 只显示当前佩戴的? | 0: 否 |
| name | str | 目标用户名 | |
| icon | str | 目标用户头像 URL | |
| uid | num | 目标用户 mid | |
| level | num | 目标用户等级 | |
`data` 对象中 `list` 数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------ | ---- |
| medal_info | obj | 勋章信息 | |
| target_name | str | 主播名称 | |
| target_icon | str | 主播头像 URL | |
| link | str | 主播主页 URL | |
| live_status | num | 直播状态 | 0: 未直播<br />1: 正在直播<br />2: 轮播中 |
| offical | num | 主播认证类型 | 参见 [用户认证类型一览](offical_role.md) |
| uinfo_medal | str | 用户勋章信息 | |
`list` 数组中的对象中的 `medal_info` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------------- | ---- | -------- | ---- |
| target_id | num | 主播 mid | |
| level | num | 勋章等级 | |
| medal_name | str | 勋章名称 | |
| medal_color_start | num | 勋章开始颜色 | 十进制(自行转换为16进制) |
| medal_color_end | num | 勋章结束颜色 | 同上 |
| medal_color_border | num | 勋章边框颜色 | 同上 |
| guard_level | num | 守护等级? | |
| wearing_status | num | 佩戴状态 | 0: 未佩戴<br />1: 佩戴中 |
| medal_id | num | 勋章 ID | |
| intimacy | num | 当前亲密度 | |
| next_intimacy | num | 下一等级所需亲密度 | |
| today_feed | num | 今日已获得亲密度 | |
| day_limit | num | 亲密度每日上限? | |
| guard_icon | str | 守护徽章图标 URL? | |
| honor_icon | str | 荣誉徽章图标 URL? | |
`list` 数组中的对象中的 `uinfo_medal` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| name | str | 勋章名称 | |
| level | num | 勋章等级 | |
| color_start | num | 勋章开始颜色 | 十进制(自行转换为16进制) |
| color_end | num | 勋章结束颜色 | 同上 |
| color_border | num | 勋章边框颜色 | 同上 |
| color | num | 勋章文本色? | 同上 |
| id | num | 勋章 ID | |
| typ | num | 勋章类型? | |
| is_light | num | 勋章亮色? | |
| ruid | num | 主播 mid | |
| guard_level | num | 守护等级? | |
| score | num | 勋章分数? | |
| guard_icon | str | 守护徽章图标 URL? | |
| honor_icon | str | 荣誉徽章图标 URL? | |
| v2_medal_color_start | str | 勋章开始颜色 | 16进制 |
| v2_medal_color_end | str | 勋章结束颜色 | 同上 |
| v2_medal_color_border | str | 勋章边框颜色 | 同上 |
| v2_medal_color_text | str | 勋章文本色 | 同上 |
| v2_medal_color_level | str | 勋章等级颜色 | 同上 |
| user_receive_count | num | 勋章已获得数量? | |
**示例:**
```shell
curl -G 'https://api.live.bilibili.com/xlive/web-ucenter/user/MedalWall' \
--url-query 'target_id=293793435' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": [
{
"medal_info": {
"target_id": 178429408,
"level": 3,
"medal_name": "滑稽果",
"medal_color_start": 6067854,
"medal_color_end": 6067854,
"medal_color_border": 6067854,
"guard_level": 0,
"wearing_status": 1,
"medal_id": 113190,
"intimacy": 248,
"next_intimacy": 500,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "老弟一号",
"target_icon": "https://i1.hdslb.com/bfs/face/21426275f3d3149b96b88783275205ba574c09e3.jpg",
"link": "https://space.bilibili.com/178429408",
"live_status": 2,
"official": 1,
"uinfo_medal": {
"name": "滑稽果",
"level": 3,
"color_start": 6067854,
"color_end": 6067854,
"color_border": 6067854,
"color": 0,
"id": 113190,
"typ": 0,
"is_light": 1,
"ruid": 178429408,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5762A799",
"v2_medal_color_end": "#5762A799",
"v2_medal_color_border": "#5762A799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 15858903,
"level": 9,
"medal_name": "二技猿",
"medal_color_start": 9272486,
"medal_color_end": 9272486,
"medal_color_border": 9272486,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 159670,
"intimacy": 168,
"next_intimacy": 1900,
"today_feed": 0,
"day_limit": 3000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "暮光小猿wzt",
"target_icon": "https://i0.hdslb.com/bfs/face/4113913241f83b03301c316fec6e4c3923bef64e.jpg",
"link": "https://space.bilibili.com/15858903",
"live_status": 0,
"official": 0,
"uinfo_medal": {
"name": "二技猿",
"level": 9,
"color_start": 9272486,
"color_end": 9272486,
"color_border": 9272486,
"color": 0,
"id": 159670,
"typ": 0,
"is_light": 1,
"ruid": 15858903,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#596FE099",
"v2_medal_color_end": "#596FE099",
"v2_medal_color_border": "#596FE099",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 24022863,
"level": 7,
"medal_name": "粉丝团",
"medal_color_start": 6126494,
"medal_color_end": 6126494,
"medal_color_border": 6126494,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 233401,
"intimacy": 1499,
"next_intimacy": 1600,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "黄禄轩电脑专用账号",
"target_icon": "https://i0.hdslb.com/bfs/face/a70ec7d2a3822980a915ef4b30371af0cbc79132.jpg",
"link": "https://space.bilibili.com/24022863",
"live_status": 2,
"official": 0,
"uinfo_medal": {
"name": "粉丝团",
"level": 7,
"color_start": 6126494,
"color_end": 6126494,
"color_border": 6126494,
"color": 0,
"id": 233401,
"typ": 0,
"is_light": 1,
"ruid": 24022863,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5866C799",
"v2_medal_color_end": "#5866C799",
"v2_medal_color_border": "#5866C799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 1347373376,
"level": 6,
"medal_name": "Geek范",
"medal_color_start": 6126494,
"medal_color_end": 6126494,
"medal_color_border": 6126494,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 658512,
"intimacy": 999,
"next_intimacy": 1500,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "GeekLogic",
"target_icon": "https://i2.hdslb.com/bfs/face/fc4ba4087efa80dce11dfdd1c2bc07d84fb603b9.jpg",
"link": "https://space.bilibili.com/1347373376",
"live_status": 0,
"official": 1,
"uinfo_medal": {
"name": "Geek范",
"level": 6,
"color_start": 6126494,
"color_end": 6126494,
"color_border": 6126494,
"color": 0,
"id": 658512,
"typ": 0,
"is_light": 1,
"ruid": 1347373376,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5866C799",
"v2_medal_color_end": "#5866C799",
"v2_medal_color_border": "#5866C799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 451664,
"level": 5,
"medal_name": "粉丝团",
"medal_color_start": 6126494,
"medal_color_end": 6126494,
"medal_color_border": 6126494,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 408689,
"intimacy": 799,
"next_intimacy": 1000,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "刘师兄_liujun",
"target_icon": "https://i2.hdslb.com/bfs/face/90665d1613cc5501a3f7bbc79b5dc83bcc30667d.jpg",
"link": "https://space.bilibili.com/451664",
"live_status": 0,
"official": 0,
"uinfo_medal": {
"name": "粉丝团",
"level": 5,
"color_start": 6126494,
"color_end": 6126494,
"color_border": 6126494,
"color": 0,
"id": 408689,
"typ": 0,
"is_light": 1,
"ruid": 451664,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5866C799",
"v2_medal_color_end": "#5866C799",
"v2_medal_color_border": "#5866C799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 89240844,
"level": 5,
"medal_name": "六零",
"medal_color_start": 6126494,
"medal_color_end": 6126494,
"medal_color_border": 6126494,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 306526,
"intimacy": 799,
"next_intimacy": 1000,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "A60_OnE",
"target_icon": "https://i0.hdslb.com/bfs/face/483513f7b0533d666fdf7eff96a70b69992056fd.jpg",
"link": "https://space.bilibili.com/89240844",
"live_status": 0,
"official": 0,
"uinfo_medal": {
"name": "六零",
"level": 5,
"color_start": 6126494,
"color_end": 6126494,
"color_border": 6126494,
"color": 0,
"id": 306526,
"typ": 0,
"is_light": 1,
"ruid": 89240844,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5866C799",
"v2_medal_color_end": "#5866C799",
"v2_medal_color_border": "#5866C799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 1850091,
"level": 5,
"medal_name": "観測者",
"medal_color_start": 6126494,
"medal_color_end": 6126494,
"medal_color_border": 6126494,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 118910,
"intimacy": 98,
"next_intimacy": 1000,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "Jannchie见齐",
"target_icon": "https://i0.hdslb.com/bfs/face/983034448f81f45f05956d0455a86fe0639d6a36.jpg",
"link": "https://space.bilibili.com/1850091",
"live_status": 2,
"official": 1,
"uinfo_medal": {
"name": "観測者",
"level": 5,
"color_start": 6126494,
"color_end": 6126494,
"color_border": 6126494,
"color": 0,
"id": 118910,
"typ": 0,
"is_light": 1,
"ruid": 1850091,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5866C799",
"v2_medal_color_end": "#5866C799",
"v2_medal_color_border": "#5866C799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 4911405,
"level": 4,
"medal_name": "毛狐狸",
"medal_color_start": 6067854,
"medal_color_end": 6067854,
"medal_color_border": 6067854,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 18887,
"intimacy": 658,
"next_intimacy": 700,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "粉毛变态老狐狸",
"target_icon": "https://i0.hdslb.com/bfs/face/5924e9201ac87066e76534472303b636a9961647.jpg",
"link": "https://space.bilibili.com/4911405",
"live_status": 0,
"official": 0,
"uinfo_medal": {
"name": "毛狐狸",
"level": 4,
"color_start": 6067854,
"color_end": 6067854,
"color_border": 6067854,
"color": 0,
"id": 18887,
"typ": 0,
"is_light": 1,
"ruid": 4911405,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5762A799",
"v2_medal_color_end": "#5762A799",
"v2_medal_color_border": "#5762A799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 130914376,
"level": 3,
"medal_name": "江草",
"medal_color_start": 6067854,
"medal_color_end": 6067854,
"medal_color_border": 6067854,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 166326,
"intimacy": 463,
"next_intimacy": 500,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "江灵夏草",
"target_icon": "https://i1.hdslb.com/bfs/face/63eb615514fddbc6024a34ddcacfb0bc6103d019.jpg",
"link": "https://space.bilibili.com/130914376",
"live_status": 0,
"official": 1,
"uinfo_medal": {
"name": "江草",
"level": 3,
"color_start": 6067854,
"color_end": 6067854,
"color_border": 6067854,
"color": 0,
"id": 166326,
"typ": 0,
"is_light": 1,
"ruid": 130914376,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5762A799",
"v2_medal_color_end": "#5762A799",
"v2_medal_color_border": "#5762A799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 316568752,
"level": 3,
"medal_name": "SEAL",
"medal_color_start": 6067854,
"medal_color_end": 6067854,
"medal_color_border": 6067854,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 312420,
"intimacy": 428,
"next_intimacy": 500,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "马督工",
"target_icon": "https://i1.hdslb.com/bfs/face/1c56737dfc0deffffc31c78e0cefb0c3ecf7e000.jpg",
"link": "https://space.bilibili.com/316568752",
"live_status": 0,
"official": 1,
"uinfo_medal": {
"name": "SEAL",
"level": 3,
"color_start": 6067854,
"color_end": 6067854,
"color_border": 6067854,
"color": 0,
"id": 312420,
"typ": 0,
"is_light": 1,
"ruid": 316568752,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5762A799",
"v2_medal_color_end": "#5762A799",
"v2_medal_color_border": "#5762A799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 633003,
"level": 3,
"medal_name": "器材党",
"medal_color_start": 6067854,
"medal_color_end": 6067854,
"medal_color_border": 6067854,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 57027,
"intimacy": 198,
"next_intimacy": 500,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "和光Channel",
"target_icon": "https://i0.hdslb.com/bfs/face/c34413202f3f4ab6c7955a2c9ca5a9ac8e86d8c2.jpg",
"link": "https://space.bilibili.com/633003",
"live_status": 0,
"official": 0,
"uinfo_medal": {
"name": "器材党",
"level": 3,
"color_start": 6067854,
"color_end": 6067854,
"color_border": 6067854,
"color": 0,
"id": 57027,
"typ": 0,
"is_light": 1,
"ruid": 633003,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5762A799",
"v2_medal_color_end": "#5762A799",
"v2_medal_color_border": "#5762A799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 5760446,
"level": 2,
"medal_name": "花泪",
"medal_color_start": 6067854,
"medal_color_end": 6067854,
"medal_color_border": 6067854,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 32283,
"intimacy": 298,
"next_intimacy": 300,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "花儿不哭",
"target_icon": "https://i2.hdslb.com/bfs/face/4f220d57ca877167f3efdc60e40d0cb53ca58b72.jpg",
"link": "https://space.bilibili.com/5760446",
"live_status": 0,
"official": 1,
"uinfo_medal": {
"name": "花泪",
"level": 2,
"color_start": 6067854,
"color_end": 6067854,
"color_border": 6067854,
"color": 0,
"id": 32283,
"typ": 0,
"is_light": 1,
"ruid": 5760446,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5762A799",
"v2_medal_color_end": "#5762A799",
"v2_medal_color_border": "#5762A799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 3644545,
"level": 2,
"medal_name": "东方狗",
"medal_color_start": 6067854,
"medal_color_end": 6067854,
"medal_color_border": 6067854,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 249059,
"intimacy": 98,
"next_intimacy": 300,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "白倉カナ",
"target_icon": "https://i1.hdslb.com/bfs/face/ae839f221a5812683fe0a3967f4a612dd65a05d2.jpg",
"link": "https://space.bilibili.com/3644545",
"live_status": 0,
"official": 0,
"uinfo_medal": {
"name": "东方狗",
"level": 2,
"color_start": 6067854,
"color_end": 6067854,
"color_border": 6067854,
"color": 0,
"id": 249059,
"typ": 0,
"is_light": 1,
"ruid": 3644545,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5762A799",
"v2_medal_color_end": "#5762A799",
"v2_medal_color_border": "#5762A799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 614801,
"level": 1,
"medal_name": "神油",
"medal_color_start": 6067854,
"medal_color_end": 6067854,
"medal_color_border": 6067854,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 627,
"intimacy": 119,
"next_intimacy": 201,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "神游八方",
"target_icon": "https://i2.hdslb.com/bfs/face/98f8e0f609ff2403cc086f7254f388336b6f5366.jpg",
"link": "https://space.bilibili.com/614801",
"live_status": 0,
"official": 1,
"uinfo_medal": {
"name": "神油",
"level": 1,
"color_start": 6067854,
"color_end": 6067854,
"color_border": 6067854,
"color": 0,
"id": 627,
"typ": 0,
"is_light": 1,
"ruid": 614801,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5762A799",
"v2_medal_color_end": "#5762A799",
"v2_medal_color_border": "#5762A799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
},
{
"medal_info": {
"target_id": 12246,
"level": 1,
"medal_name": "纯色派",
"medal_color_start": 6067854,
"medal_color_end": 6067854,
"medal_color_border": 6067854,
"guard_level": 0,
"wearing_status": 0,
"medal_id": 5171,
"intimacy": 99,
"next_intimacy": 201,
"today_feed": 0,
"day_limit": 2000,
"guard_icon": "",
"honor_icon": ""
},
"target_name": "囧仙",
"target_icon": "https://i0.hdslb.com/bfs/face/b7ee967282a33a59908218df5b240b45f51afda8.jpg",
"link": "https://space.bilibili.com/12246",
"live_status": 0,
"official": 1,
"uinfo_medal": {
"name": "纯色派",
"level": 1,
"color_start": 6067854,
"color_end": 6067854,
"color_border": 6067854,
"color": 0,
"id": 5171,
"typ": 0,
"is_light": 1,
"ruid": 12246,
"guard_level": 0,
"score": 0,
"guard_icon": "",
"honor_icon": "",
"v2_medal_color_start": "#5762A799",
"v2_medal_color_end": "#5762A799",
"v2_medal_color_border": "#5762A799",
"v2_medal_color_text": "#FFFFFFFF",
"v2_medal_color_level": "#000B7099",
"user_receive_count": 0
}
}
],
"count": 15,
"close_space_medal": 0,
"only_show_wearing": 0,
"name": "社会易姐QwQ",
"icon": "https://i0.hdslb.com/bfs/face/aebb2639a0d47f2ce1fec0631f412eaf53d4a0be.jpg",
"uid": 645769214,
"level": 6
}
}
```
</details>

View File

@@ -2559,6 +2559,8 @@ curl -G 'https://app.bilibili.com/x/v2/space/likearc' \
鉴权方式:[Wbi 签名](../misc/sign/wbi.md)
另见 [根据关键词查找视频](../video/collection.md#根据关键词查找视频), 功能基本相同, 暂未发现风控校验
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@@ -2778,6 +2780,11 @@ curl -G 'https://api.bilibili.com/x/space/arc/search' \
### 查询用户投稿相簿预览
<details>
<summary>相簿功能已下线, 以下接口失效, 参见
<a href="https://github.com/SocialSisterYi/bilibili-API-collect/issues/801">#801</a>
</summary>
> https://api.bilibili.com/x/space/album/index
*请求方式GET*
@@ -2905,8 +2912,15 @@ curl -G 'https://api.bilibili.com/x/space/album/index' \
</details>
</details>
### 查询用户投稿相簿明细
<details>
<summary>
相簿功能已下线, 以下接口失效
</summary>
> https://api.vc.bilibili.com/link_draw/v1/doc/doc_list
> https://api.bilibili.com/x/dynamic/feed/draw/doc_list
@@ -3050,6 +3064,8 @@ curl -G 'https://api.vc.bilibili.com/link_draw/v1/doc/doc_list' \
</details>
</details>
## 频道
<img src="../../assets/img/channel.svg" width="100" height="100" />
@@ -3784,280 +3800,6 @@ curl -G 'https://api.bilibili.com/x/space/channel/video/check
</details>
## 收藏
<img src="../../assets/img/collect.svg" width="100" height="100" />
### 查询用户创建的视频收藏夹
> https://api.bilibili.com/x/v3/fav/folder/created/list-all
*请求方式GET*
认证方式CookieSESSDATA
查看私有收藏夹时需要认证
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| up_mid | num | 目标用户mid | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | --------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 隐藏时null<br />公开时obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----- | --------------------------------------- | -------------- | ---- |
| count | num | 创建的收藏夹数 | |
| list | 无收藏夹时null<br />有收藏夹时array | 收藏夹列表 | |
`data`中的`list`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | --------------------- |
| 0 | obj | 收藏夹1 | |
| n | obj | 收藏夹(n+1) | 项数取决于`count`的值 |
| …… | obj | …… | |
`data`中的`list`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------------- | --------------- |
| id | num | 收藏夹mlid | |
| fid | num | 原始收藏夹mlid | 去除两位mid尾号 |
| mid | num | 创建用户mid | |
| attr | num | 收藏夹属性位配置 | |
| title | str | 收藏夹标题 | |
| fav_state | num | 0 | 作用尚不明确 |
| media_count | num | 收藏夹总计视频数 | |
`attr`属性位二进制值表:
| 位 | 内容 | 备注 |
| --------------- | ---------------- | -------------------------------- |
| 0 | 是否为默认收藏夹 | 0默认收藏夹<br />1其他收藏夹 |
| 1 | 私有收藏夹 | 0公开<br />1私有 |
| 其他有待补充... | | |
**示例:**
查询用户`mid=7792521`的收藏夹列表
```shell
curl -G 'https://api.bilibili.com/x/v3/fav/folder/created/list-all' \
--data-urlencode 'up_mid=7792521' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"count": 5,
"list": [{
"id": 44233921,
"fid": 442339,
"mid": 7792521,
"attr": 0,
"title": "默认收藏夹",
"fav_state": 0,
"media_count": 85
}, {
"id": 936347621,
"fid": 9363476,
"mid": 7792521,
"attr": 22,
"title": "放假君的鬼畜私房歌",
"fav_state": 0,
"media_count": 2
}, {
"id": 845218621,
"fid": 8452186,
"mid": 7792521,
"attr": 22,
"title": "♪一言不合就开唱♪",
"fav_state": 0,
"media_count": 4
}, {
"id": 844998121,
"fid": 8449981,
"mid": 7792521,
"attr": 22,
"title": "个人作品精选",
"fav_state": 0,
"media_count": 25
}, {
"id": 381779121,
"fid": 3817791,
"mid": 7792521,
"attr": 22,
"title": "鬼畜小课堂",
"fav_state": 0,
"media_count": 25
}]
}
}
```
</details>
### 查询用户收藏的视频收藏夹
> https://api.bilibili.com/x/v3/fav/folder/collected/list
*请求方式GET*
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| ps | num | 每页项数 | 必要 | 定义域 1 - 大于70 |
| pn | num | 页码 | 必要 | |
| up_mid | num | 目标用户mid | 必要 | |
| platform | str | 平台类型 | 非必要 | 填写web 返回值才会包含用户收藏的视频合集 |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf校验失败<br />40022签名过长 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 隐藏时null<br />公开时obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ----- | --------------------------------------- | -------------- | ---- |
| count | num | 创建的收藏夹数 | |
| list | 无收藏夹时null<br />有收藏夹时array | 收藏夹列表 | |
`data`中的`list`数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | --------------------- |
| 0 | obj | 收藏夹1 | |
| n | obj | 收藏夹(n+1) | 项数取决于`count`的值 |
| …… | obj | …… | |
`data`中的`list`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ------------------ | ----------------------------------------- |
| id | num | 收藏夹ml | |
| fid | num | 原始收藏夹mlid | 去除两位mid尾号 |
| mid | num | 创建用户mid | |
| attr | num | 收藏夹属性 | 转换成8-bit二进制处理<br />详细说明见下表 |
| title | str | 收藏夹标题 | |
| cover | str | 收藏夹封面图片url | |
| upper | obj | 收藏夹创建用户信息 | |
| cover_type | num | 2 | 作用尚不明确 |
| intro | str | 空 | 作用尚不明确 |
| ctime | num | 创建时间 | 时间戳 |
| mtime | num | 审核时间 | 时间戳 |
| state | num | 0, 1 | 0: 正常1:收藏夹已失效 |
| fav_state | num | 0 | 作用尚不明确 |
| media_count | num | 收藏夹总计视频数 | |
`attr`属性二进制值表:
| 其他有待补充... | 1默认收藏夹 | 0公开性 |
| --------------- | -------------------------------- | -------------------- |
| | 0默认收藏夹<br />1其他收藏夹 | 0公开<br />1私有 |
`data`中的`list`数组中的对象中的`upper`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---------- | ------------ |
| mid | num | 创建人mid | |
| name | str | 创建人昵称 | |
| face | str | 空 | 作用尚不明确 |
**示例:**
查询用户`mid=293793435`的收藏夹收藏列表
```shell
curl -G 'https://api.bilibili.com/x/v3/fav/folder/collected/list' \
--data-urlencode 'up_mid=293793435' \
--data-urlencode 'ps=20' \
--data-urlencode 'pn=1' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"count": 2,
"list": [{
"id": 496307088,
"fid": 4963070,
"mid": 412466388,
"attr": 22,
"title": "入站必刷",
"cover": "http://i0.hdslb.com/bfs/archive/baae2b4050363c0ab45465b7cf696b8304fdaca8.jpg",
"upper": {
"mid": 412466388,
"name": "热门菌",
"face": ""
},
"cover_type": 2,
"intro": "",
"ctime": 1563394571,
"mtime": 1563394571,
"state": 0,
"fav_state": 0,
"media_count": 55
}, {
"id": 381779121,
"fid": 3817791,
"mid": 7792521,
"attr": 22,
"title": "鬼畜小课堂",
"cover": "http://i2.hdslb.com/bfs/archive/09a668cfdb38fb3a85f905c10f48a2947e36a695.jpg",
"upper": {
"mid": 7792521,
"name": "还有一天就放假了",
"face": ""
},
"cover_type": 2,
"intro": "",
"ctime": 1553700224,
"mtime": 1557291666,
"state": 0,
"fav_state": 0,
"media_count": 25
}]
}
}
```
</details>
## 课程
<img src="../../assets/img/class.svg" width="100" height="100" />

View File

@@ -145,10 +145,8 @@ curl -G 'https://api.bilibili.com/x/space/upstat' \
</details>
## ~~订阅&投稿状态数(已弃用)~~
## 用户导航栏状态数
<details>
<summary>查看折叠内容</summary>
> https://api.bilibili.com/x/space/navnum
*请求方式GET*
@@ -158,6 +156,7 @@ curl -G 'https://api.bilibili.com/x/space/upstat' \
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户mid | 必要 | |
| web_location | str | 333.999 | 不必要 ||
**json回复**
@@ -177,37 +176,38 @@ curl -G 'https://api.bilibili.com/x/space/upstat' \
| video | num | 投稿视频数 | |
| bangumi | num | 追番数 | 无视隐私设置 |
| cinema | num | 追剧数 | 无视隐私设置 |
| channel | obj | 频道数 | |
| favourite | obj | 收藏夹数 | 无视隐私设置 |
| channel | obj | 视频列表数 | |
| favourite | obj | 收藏夹数 | |
| tag | num | 关注TAG数 | 无视隐私设置 |
| article | num | 投稿专栏数 | |
| playlist | num | 0 | 作用尚不明确 |
| album | num | 投稿相簿数 | |
| album | num | 投稿图文数 | |
| audio | num | 投稿音频数 | |
| pugv | num | 投稿课程数 | |
| upos | num | 动态数 | |
| season_num | num | 视频合集数 | |
`data`中的`channel`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | ---------- | ------------ |
| master | num | 频道数 | |
| guest | num | 频道数 | |
| master | num | 视频列表数 | |
| guest | num | 视频列表数 | |
`data`中的`favourite`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | ------------ | --------------------------------------- |
| master | num | 全部收藏夹数 | 需要登录(SESSDATA) <br />只能查看自己的 |
| guest | num | 公开收藏夹数 | 无视隐私设置 |
| guest | num | 公开收藏夹数 | |
**示例:**
查询用户`mid=239202390`的订阅&投稿状态数
查询用户`mid=645769214`的订阅&投稿状态数
```shell
curl -G 'https://api.bilibili.com/x/space/navnum' \
--data-urlencode 'mid=239202390' \
-b 'SESSDATA=xxx'
--data-urlencode 'mid=645769214'
```
<details>
@@ -215,32 +215,33 @@ curl -G 'https://api.bilibili.com/x/space/navnum' \
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"video": 290,
"bangumi": 25,
"cinema": 13,
"channel": {
"master": 2,
"guest": 2
},
"favourite": {
"master": 6,
"guest": 6
},
"tag": 0,
"article": 1,
"playlist": 0,
"album": 150,
"audio": 4,
"pugv": 0
}
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"video": 34,
"bangumi": 1,
"cinema": 0,
"channel": {
"master": 5,
"guest": 5
},
"favourite": {
"master": 0,
"guest": 0
},
"tag": 0,
"article": 1,
"playlist": 0,
"album": 59,
"audio": 0,
"pugv": 0,
"season_num": 1,
"opus": 59
}
}
```
</details>
</details>
## 相簿投稿数