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

调整部分接口描述与错误修复 (#1088)

Browse Source 
* fix(search/search_request.md): cookie buvid3

* feat(login/login_action/password.md): more sms desc

* fix: typo

* feat(live/info.md): add ps for getRoomBaseInfo

* fix(danmaku/action.md): broken form

* chore: Browserslist: caniuse-lite is outdated

* feat(comment/list.md): reply/wbi/main param next

* feat(misc/buvid3_4.md): get buvid3 only

* fix: broken links & wrong code type

* feat: close all img & br tags

* feat(login/cookie_refresh.md): missing demo links

* feat(dynamic/detail.md): /lottery_svr/v1/lottery_svr/lottery_notice

* fix(video/action.md): share cookie buvid3

* feat: deprecated stat & attribute

* feat(dynamic/detail.md): reaction

* feat(misc/sign/v_voucher.md): header

* feat(dynamic/detail.md): update detail params & example

* feat(APP_widget/ver.md): /x/v2/version

* feat(video/info.md): update view

* feat(docs/user.md): remove channel

* feat(search/search_request.md): search/type -1200

* feat(user/space.md): audio

* feat(video/player.md): /x/player/wbi/v2

* feat(audio/musicstream_url.md): update web/url

* feat(comment/readme.md): state

* fix(user/medal.md): wrong guard_level desc

* feat(live/message_stream.md): DANMU_MSG

* fix(user/medals): wrong guard_level & guard_icon desc

* feat(live/message_stream.md): format & add more 'cmd'

* feat(live/message_stream.md): add more 'cmd'

* feat(live/message_stream.md): add tips for non-login users

* feat(video/player.md): need_login_subtitle

---------

Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
This commit is contained in:
Session小胡
2024-09-19 23:17:33 +08:00
committed by GitHub
parent 2dbdcd884d
commit 1e24c6b188
32 changed files with 4207 additions and 2654 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
docs/user/medals.md
View File

@@ -51,7 +51,7 @@
| target_icon | str | 主播头像 URL | |
| link | str | 主播主页 URL | |
| live_status | num | 直播状态 | 0: 未直播<br />1: 正在直播<br />2: 轮播中 |
| offical | num | 主播认证类型 | 参见 [用户认证类型一览](offical_role.md) |
| offical | num | 主播认证类型 | 参见 [用户认证类型一览](official_role.md) |
| uinfo_medal | str | 用户勋章信息 | |
`list` 数组中的对象中的 `medal_info` 对象:
@@ -64,7 +64,7 @@
| medal_color_start | num | 勋章开始颜色 | 十进制(自行转换为16进制) |
| medal_color_end | num | 勋章结束颜色 | 同上 |
| medal_color_border | num | 勋章边框颜色 | 同上 |
| guard_level | num | 守护等级? | |
| guard_level | num | 守护等级? | 1: 总督<br />2: 提督<br />3: 舰长 |
| wearing_status | num | 佩戴状态 | 0: 未佩戴<br />1: 佩戴中 |
| medal_id | num | 勋章 ID | |
| intimacy | num | 当前亲密度 | |
@@ -80,17 +80,17 @@
| ---- | ---- | ---- | ---- |
| name | str | 勋章名称 | |
| level | num | 勋章等级 | |
| color_start | num | 勋章开始颜色 | 十进制(自行转换为16进制) |
| color_end | num | 勋章结束颜色 | 同上 |
| color_start | num | 勋章渐变开始颜色 | 十进制(自行转换为16进制) |
| color_end | num | 勋章渐变结束颜色 | 同上 |
| color_border | num | 勋章边框颜色 | 同上 |
| color | num | 勋章文本色? | 同上 |
| color | num | 勋章颜色 | 同上 |
| id | num | 勋章 ID | |
| typ | num | 勋章类型? | |
| is_light | num | 勋章亮色? | |
| is_light | num | 是否点亮? | |
| ruid | num | 主播 mid | |
| guard_level | num | 守护等级? | |
| guard_level | num | 大航海等级 | 1: 总督<br />2: 提督<br />3: 舰长 |
| score | num | 勋章分数? | |
| guard_icon | str | 守护徽章图标 URL? | |
| guard_icon | str | 大航海图标 URL? | 粉丝牌左边的图标 |
| honor_icon | str | 荣誉徽章图标 URL? | |
| v2_medal_color_start | str | 勋章开始颜色 | 16进制 |
| v2_medal_color_end | str | 勋章结束颜色 | 同上 |

2
docs/user/register.md
View File

@@ -60,7 +60,7 @@ curl 'https://passport.bilibili.com/web/sms/general/v2/send' \
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------------------------- |
| code | num | 返回值 | 0：成功<br>1005：验证码错误<br>1007：验证码过期 |
| code | num | 返回值 | 0：成功<br />1005：验证码错误<br />1007：验证码过期 |
| message | str | 错误信息 | 成功时无此字段 |
| data | obj | 信息本体 | 只在成功时存在 |

911
docs/user/space.md
View File

@@ -842,8 +842,8 @@ curl 'https://api.bilibili.com/x/space/notice/set' \
| 字段 | 类型 | 内容 | 备注 |
| ------ | ------------------- | -------- | ---- |
| status | bool | 用户是否存在 | true：存在<br>false：不存在 |
| data | 用户存在时：obj<br>用户不存在时：str| 用户存在时：信息本体<br>用户不存在时：错误信息 | |
| status | bool | 用户是否存在 | true：存在<br />false：不存在 |
| data | 用户存在时：obj<br />用户不存在时：str| 用户存在时：信息本体<br />用户不存在时：错误信息 | |
`data`对象：
@@ -859,7 +859,7 @@ curl 'https://api.bilibili.com/x/space/notice/set' \
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | -------------- | ------------------------------ |
| bangumi | num | 追番及追剧 | 0：隐藏<br>1：公开<br>**下同** |
| bangumi | num | 追番及追剧 | 0：隐藏<br />1：公开<br />**下同** |
| bbq | num | 轻视频 | |
| channel | num | 频道 | |
| coins_video | num | 最近投币的视频 | |
@@ -876,7 +876,7 @@ curl 'https://api.bilibili.com/x/space/notice/set' \
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------- | -------------------------------------------- |
| 0 | obj | 板块1 | 根据板块布局顺序排序<br>先左侧布局后右侧布局 |
| 0 | obj | 板块1 | 根据板块布局顺序排序<br />先左侧布局后右侧布局 |
| n | obj | 板块(n+1) | |
| …… | obj | …… | …… |
@@ -3066,739 +3066,184 @@ curl -G 'https://api.vc.bilibili.com/link_draw/v1/doc/doc_list' \
</details>
### 查询用户投稿音频明细
> https://api.bilibili.com/audio/music-service/web/song/upper
*请求方法: GET*
<!--{
"from": {
"url": "https://space.bilibili.com/8047632/audio",
"selector": ".be-tab-inner"
}
"gh": [442]
}-->
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --- | --- | --- | --- | --- |
| mid | num | 用户 mid | 必要 | |
| pn | num | 页码 | 必要 | 默认为 1 |
| ps | num | 每页项数 | 必要 | 默认为 30 |
| order | str | 排序方式 | 必要 | 1: 最新发布<br />2: 最多播放<br />3: 最多收藏 |
**JSON回复:**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| code | num | 返回值 | 0: 成功<br />72000000: 缺少参数 |
| msg | str | 返回信息 | 成功为 `success` |
| data | str | 数据本体 | 失败时不存在 |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| curPage | num | 当前页码 | |
| pageCount | num | 总页数 | |
| totalSize | num | 总计数 | |
| pageSize | num | 每页项数 | |
| data | array | 音频列表 | |
`data` 对象中的 `data` 数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| id | num | 音频 AU 号 | |
| uid | num | 用户 mid | |
| uname | str | 用户名 | |
| author | null | | |
| title | str | 音频标题 | |
| cover | str | 音频封面图片 URL | |
| intro | null | | |
| lyric | str | 音频歌词 URL | |
| crtype | num | 1 | |
| duration | num | 音频时长 | 单位为 秒 |
| passtime | num | 发布时间 | UNIX 秒级时间戳 |
| curtime | num | 0 | |
| aid | null | | |
| cid | null | | |
| msid | null | | |
| attr | null | | |
| limit | null | | |
| activityId | null | | |
| limitdesc | null | | |
| ctime | num | 发布时间 | UNIX 毫秒时间戳 |
| statistic | obj | 统计数 | |
| coin_num | num | 硬币数量 | |
| is_cooper | null | | |
`data` 数组中的对象中的 `statistic` 对象:
| 字段 | 类型 | 内容 | 备注 |
| --- | --- | --- | --- |
| sid | num | 音频 AU 号 | |
| play | num | 播放数 | |
| collect | num | 收藏数 | |
| comment | num | 评论数 | |
| share | num | 分享数 | |
**示例:**
```shell
curl -G 'https://api.bilibili.com/audio/music-service/web/song/upper' \
--url-query 'uid=8047632' \
--url-query 'pn=1' \
--url-query 'ps=30' \
--url-query 'order=2'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"msg": "success",
"data": {
"curPage": 1,
"pageCount": 1,
"totalSize": 2,
"pageSize": 30,
"data": [
{
"id": 257709,
"uid": 8047632,
"uname": "哔哩哔哩弹幕网",
"author": null,
"title": "【2018拜年祭单品】与你同行~B With U~",
"cover": "http://i0.hdslb.com/bfs/music/0f890889c8e1101f37317def0c4c555068054c88.jpg",
"intro": null,
"lyric": "http://i0.hdslb.com/bfs/music/1519959250257709.lrc",
"crtype": 1,
"duration": 301,
"passtime": 1519878405,
"curtime": 0,
"aid": null,
"cid": null,
"msid": null,
"attr": null,
"limit": null,
"activityId": null,
"limitdesc": null,
"ctime": 1519875632000,
"statistic": {
"sid": 257709,
"play": 845264,
"collect": 21978,
"comment": 1983,
"share": 1685
},
"coin_num": 13368,
"is_cooper": null
},
{
"id": 378521,
"uid": 8047632,
"uname": "哔哩哔哩弹幕网",
"author": null,
"title": "《B TOGETHER》-bilibili九周年主题曲",
"cover": "http://i0.hdslb.com/bfs/music/109136c63e16d83fbad5ec9282a6fb96498d8144.jpg",
"intro": null,
"lyric": "http://i0.hdslb.com/bfs/music/1529979007378521.lrc",
"crtype": 1,
"duration": 261,
"passtime": 1529928347,
"curtime": 0,
"aid": null,
"cid": null,
"msid": null,
"attr": null,
"limit": null,
"activityId": null,
"limitdesc": null,
"ctime": 1529928235000,
"statistic": {
"sid": 378521,
"play": 123264,
"collect": 5501,
"comment": 1591,
"share": 535
},
"coin_num": 3640,
"is_cooper": null
}
]
}
}
```
</details>
## 频道
<img src="../../assets/img/channel.svg" width="100" height="100" />
### 查询用户频道列表
> https://api.bilibili.com/x/space/channel/list
*请求方式：GET*
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户mid | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | -------- |
| code | num | 返回值 | 0：成功 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | 无则为空 所有频道内均无视频则为空，此时code为0 |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ------ | ---------- | ---- |
| count | num | 总计频道数 | |
| list | array | 频道列表 | |
`data`中的`list`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | --------------------- |
| 0 | obj | 频道1 | |
| n | obj | 频道（n+1） | 项数取决于`count`的值 |
| …… | obj | …… | …… |
`data`中的`list`数组中的对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------------- | -------- |
| cid | num | 频道id | |
| count | num | 频道内含视频数 | |
| cover | str | 封面图片url | |
| intro | str | 简介 | 无则为空 |
| mid | num | 创建用户mid | |
| mtime | num | 创建时间 | 时间戳 |
| name | str | 标题 | |
**示例：**
查询用户`mid=53456`的频道列表
```shell
curl -G 'https://api.bilibili.com/x/space/channel/list' \
--data-urlencode 'mid=53456'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"count": 6,
"list": [{
"cid": 100249,
"mid": 53456,
"name": "【实况】动物之森",
"intro": "",
"mtime": 1579898830,
"count": 2,
"cover": "http://i1.hdslb.com/bfs/archive/6a7ed9483c34e839dfca981b9e2b94cd4c4efa0a.jpg"
}, {
"cid": 79323,
"mid": 53456,
"name": "忆雨",
"intro": "忆雨出现过的视频",
"mtime": 1562535222,
"count": 7,
"cover": "http://i2.hdslb.com/bfs/archive/1783e4f03042b282495799adda1cb56270cea647.jpg"
}, {
"cid": 79322,
"mid": 53456,
"name": "大画家",
"intro": "",
"mtime": 1562535122,
"count": 6,
"cover": "http://i0.hdslb.com/bfs/archive/9c85a14e805c6c23cb7a42e1dbef97821bb68960.jpg"
}, {
"cid": 77758,
"mid": 53456,
"name": "灭火器",
"intro": "",
"mtime": 1561270856,
"count": 4,
"cover": "http://i2.hdslb.com/bfs/archive/0073208d086b4ebe9cdc540e7664aa74b483aeb6.jpg"
}, {
"cid": 75696,
"mid": 53456,
"name": "沃玛小剧场",
"intro": "",
"mtime": 1559129460,
"count": 5,
"cover": "http://i2.hdslb.com/bfs/archive/db2b20ecdb6ed013fc3780b0e741ea88d46b5b40.jpg"
}, {
"cid": 170,
"mid": 53456,
"name": "爆炸电台",
"intro": "闲聊的电台",
"mtime": 1503298893,
"count": 7,
"cover": "http://i2.hdslb.com/bfs/archive/73d77bc6bb0d44b239fd4f5a2682fe3144e81692.jpg"
}]
}
}
```
</details>
### 查询用户频道中的视频
> https://api.bilibili.com/x/space/channel/video
*请求方式：GET*
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | --------- |
| mid | num | 目标用户mid | 必要 | |
| cid | num | 目标频道id | 必要 | |
| pn | num | 页码 | 非必要 | 默认为1 |
| ps | num | 每页项数 | 非必要 | 默认为100 |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------- |
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-404：无用户对应的频道 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| list | obj | 频道信息 | |
| page | obj | 页面信息 | |
`data`中的`list`对象：
| 字段 | 类型 | 内容 | 备注 |
| -------- | ------ | -------------- | -------- |
| archives | array | 包含的视频列表 | |
| cid | num | 频道id | |
| count | num | 频道内含视频数 | |
| cover | str | 封面图片url | |
| intro | str | 简介 | 无则为空 |
| mid | num | 创建用户mid | |
| mtime | num | 创建时间 | 时间戳 |
| name | str | 标题 | |
`list`中的`archives`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ----------- | --------------------- |
| 0 | obj | 视频1 | |
| n | obj | 视频（n+1） | 项数取决于`count`的值 |
| …… | obj | …… | …… |
`list`中的`archives`数组中的对象：
基本同「[视频详细信息](https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/video/info.md#视频详细信息（avid/bvid互转）)」中的data对象
`data`中的`page`对象：
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ---------- | ---- |
| count | num | 总计视频数 | |
| num | num | 当前页码 | |
| size | num | 每页项数 | |
**示例：**
查询用户`mid=53456`的频道`170`中的视频
```shell
curl -G 'https://api.bilibili.com/x/space/channel/video' \
--data-urlencode 'mid=53456' \
--data-urlencode 'cid=170' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"list": {
"cid": 170,
"mid": 53456,
"name": "爆炸电台",
"intro": "闲聊的电台",
"mtime": 1503298893,
"count": 7,
"cover": "http://i2.hdslb.com/bfs/archive/73d77bc6bb0d44b239fd4f5a2682fe3144e81692.jpg",
"archives": [{
"aid": 87673204,
"videos": 1,
"tid": 21,
"tname": "日常",
"copyright": 1,
"pic": "http://i0.hdslb.com/bfs/archive/5387bdcbbe4d5551adbf0ee2e607e4b7d3d8f2f0.jpg",
"title": "【warma爆炸电台】迟来的自我介绍【第八期】",
"pubdate": 1581244539,
"ctime": 1581244540,
"desc": "时隔半年的新的一期爆炸电台来啦，这是我的一系列杂谈聊天电台，这次因为多了很多新关注的朋友们，所以来做个自我介绍吧！\n画师：Dr-H_喵_ 动画：K_Lacid\n结尾提到的壁纸稍后在动态发原图，动态壁纸在steam那个壁纸软件的创意工坊里搜warma能找到\n\n往期的电台：\n第一期：av6786024 \n第三期：av13619263\n第四期：av18862091\n第五期：av25092410\n第六期：av42492515\n第七期：av62910468",
"state": 0,
"attribute": 16512,
"duration": 2388,
"rights": {
"bp": 0,
"elec": 0,
"download": 0,
"movie": 0,
"pay": 0,
"hd5": 0,
"no_reprint": 1,
"autoplay": 1,
"ugc_pay": 0,
"is_cooperation": 0,
"ugc_pay_preview": 0,
"no_background": 0
},
"owner": {
"mid": 53456,
"name": "Warma",
"face": "http://i1.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg"
},
"stat": {
"aid": 87673204,
"view": 1383542,
"danmaku": 88908,
"reply": 9237,
"favorite": 32929,
"coin": 68849,
"share": 5140,
"now_rank": 0,
"his_rank": 52,
"like": 116164,
"dislike": 0
},
"dynamic": "来做个自我介绍吧！ #warma##沃玛##爆炸电台#",
"cid": 149793525,
"dimension": {
"width": 1920,
"height": 1080,
"rotate": 0
},
"bvid": "BV1D7411t7Be",
"inter_video": false
}, {
"aid": 62910468,
"videos": 1,
"tid": 21,
"tname": "日常",
"copyright": 1,
"pic": "http://i2.hdslb.com/bfs/archive/4bd598f71a144d4505e259b143c0de0bf27968b2.jpg",
"title": "【warma爆炸电台】居然收到了几千条问题！【第七期】",
"pubdate": 1565345410,
"ctime": 1565338559,
"desc": "时隔半年的爆炸电台第七期终于来啦！在这一期里回答了很多问题，祝看得开心！此外，就在昨天，50万订阅了…真的谢谢大家！\n也欢迎来看往期的电台：\n第一期：av6786024 （2016年10月）\n第二期：av10373352（2017年5月）\n第三期：av13619263（2017年8月）\n第四期：av18862091（2018年1月）\n第五期：av25092410（2018年6月）\n第六期：av42492515（2019年2月）",
"state": 0,
"attribute": 16512,
"duration": 1987,
"mission_id": 11740,
"rights": {
"bp": 0,
"elec": 0,
"download": 0,
"movie": 0,
"pay": 0,
"hd5": 0,
"no_reprint": 1,
"autoplay": 1,
"ugc_pay": 0,
"is_cooperation": 0,
"ugc_pay_preview": 0,
"no_background": 0
},
"owner": {
"mid": 53456,
"name": "Warma",
"face": "http://i1.hdslb.com/bfs/face/c1bbee6d255f1e7fc434e9930f0f288c8b24293a.jpg"
},
"stat": {
"aid": 62910468,
"view": 455277,
"danmaku": 19383,
"reply": 2108,
"favorite": 10507,
"coin": 19422,
"share": 1208,
"now_rank": 0,
"his_rank": 0,
"like": 31515,
"dislike": 0
},
"dynamic": "爆炸电台 第七期 来啦！",
"cid": 109284065,
"dimension": {
"width": 1920,
"height": 1080,
"rotate": 0
},
"bvid": "BV1gt411K7Ga",
"inter_video": false
}]
},
"page": {
"count": 7,
"num": 1,
"size": 2
}
}
}
```
</details>
### 创建频道
> https://api.bilibili.com/x/space/channel/add
*请求方式：POST*
认证方式：Cookie（SESSDATA）
创建成功后会返回新建频道的id
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| name | str | 频道名 | 必要 | |
| intro | str | 频道简介 | 非必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />53001：频道名字数超过限制<br />53002：频道简介字数超过限制<br />53004：创建的频道已经满额<br />53007：频道名称已经存在<br />53024：编辑内容命中敏感信息 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 数据本体 | 成功有此项 |
`data`对象：
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ------ | ---- |
| cid | num | 频道id | |
**示例：**
创建名为`test1`的频道，简介为空
```shell
curl 'https://api.bilibili.com/x/space/channel/add' \
--data-urlencode 'name=test1' \
--data-urlencode 'intro=' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"cid": 138996
}
}
```
</details>
### 修改频道
> https://api.bilibili.com/x/space/channel/edit
*请求方式：POST*
认证方式：Cookie（SESSDATA）
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 频道id | 必要 | |
| name | str | 频道名 | 必要 | |
| intro | str | 频道简介 | 非必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />53001：频道名字数超过限制<br />53002：频道简介字数超过限制<br />53007：频道名称已经存在<br />53024：编辑内容命中敏感信息 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
**示例：**
修改频道`138996`名称为`测试`，简介为`123456`
```shell
curl 'https://api.bilibili.com/x/space/channel/edit' \
--data-urlencode 'cid=138996' \
--data-urlencode 'name=测试' \
--data-urlencode 'intro=123456' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
</details>
### 删除频道
> https://api.bilibili.com/x/space/channel/del
*请求方式：POST*
认证方式：Cookie（SESSDATA）
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 需要删除的频道id | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
**示例：**
删除频道`138996`
```shell
curl 'https://api.bilibili.com/x/space/channel/del' \
--data-urlencode 'cid=138996' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
</details>
### 频道添加视频
> https://api.bilibili.com/x/space/channel/video/add
*请求方式：POST*
认证方式：Cookie（SESSDATA）
仅能添加自己是UP主的视频
如添加多个视频，仅会添加正确的
**注：完成后需要使用接口「查询用户频道中的视频」刷新**
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---------------------- |
| cid | num | 频道id | 必要 | |
| aids | nums | 要添加的目标稿件avid | 必要 | 多个使用","（%2C）分隔 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | ---------------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />53003：本频道里的视频已满<br />53006：提交视频已失效或频道里有（非该视频UP主） |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | array | 出错稿件avid列表 | |
`data`数组：
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------- | ---- |
| 0 | num | 出错稿件avid1 | |
| n | num | 出错稿件avid（n+1） | |
| …… | num | …… | …… |
**示例：**
向频道`138995`中添加视频`av583785685`和`av243322853`
```shell
curl 'https://api.bilibili.com/x/space/channel/video/add' \
--data-urlencode 'cid=138995' \
--data-urlencode 'aids=583785685,243322853' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": []
}
```
</details>
### 频道删除视频
> https://api.bilibili.com/x/space/channel/video/del
*请求方式：POST*
认证方式：Cookie（SESSDATA）
**注：完成后需要使用接口「查询用户频道中的视频」刷新**
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 频道id | 必要 | |
| aid | num | 要删除的目标稿件avid | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />53008：频道内没有视频<br />53009：频道内没有该视频 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
**示例：**
删除频道`138995`中的视频`av583785685`
```shell
curl 'https://api.bilibili.com/x/space/channel/video/del' \
--data-urlencode 'cid=138995' \
--data-urlencode 'aid=583785685' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
</details>
### 调整频道视频排序
> https://api.bilibili.com/x/space/channel/video/sort
*请求方式：POST*
认证方式：Cookie（SESSDATA）
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| cid | num | 频道id | 必要 | |
| aid | num | 要移动的目标稿件avid | 必要 | |
| to | num | 视频排序倒数位置 | 非必要 | 默认为1<br />1为列表底部，视频总数为首端<br />与显示顺序恰好相反 |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
**示例：**
调整`138995`中的视频`av583785685`位置为倒数第2
```shell
curl 'https://api.bilibili.com/x/space/channel/video/sort' \
--data-urlencode 'cid=138995' \
--data-urlencode 'aid=583785685' \
--data-urlencode 'to=2' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
</details>
### 检查频道中有无失效视频
> https://api.bilibili.com/x/space/channel/video/check
*请求方式：GET*
认证方式：Cookie（SESSDATA）
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ---- |
| cid | num | 目标频道id | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-400：请求错误<br />-404：无此项<br />53005：频道内有失效视频 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
**示例：**
检查频道`138995`
```shell
curl -G 'https://api.bilibili.com/x/space/channel/video/check
--data-urlencode 'cid=138995' \
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例：</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
</details>
[所有旧接口](https://github.com/SocialSisterYi/bilibili-API-collect/blob/7d89ece2ac46425810647c4ac92acf5f3721cb68/docs/user/space.md#%E9%A2%91%E9%81%93) 已弃用, 现可用接口参见 [合集和视频列表信息](../video/collection.md)
## 课程