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

继续修改文档格式 补完频道相关接口

Browse Source
This commit is contained in:
SocialSisterYi
2020-07-19 21:56:58 +08:00
parent 33f693dd41
commit 26560f16d9
17 changed files with 386 additions and 86 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
user/info.md
View File

@@ -7,6 +7,8 @@
*请求方式：GET*
认证方式：Cookie（SESSDATA）
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@@ -39,13 +41,13 @@
| moral | num | 0 | **作用尚不明确** |
| silence | num | 封禁状态 | 0：正常<br />1：被封 |
| birthday | str | 生日 | MM-DD |
| coins | num | 硬币数 | 需要登录(SESSDATA) <br />只能查看自己的<br />默认为0 |
| 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 />需要登录(SESSDATA) <br />未登录恒为false |
| is_followed | bool | 是否关注此用户 | true：已关注<br />false：未关注<br />需要登录(Cookie) <br />未登录恒为false |
| top_photo | str | 主页头图链接 | |
| theme | obj | 空 | **作用尚不明确** |
| sys_notice | obj | 系统通知 | 无内容则为空 |
@@ -209,6 +211,8 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
*请求方式：GET*
认证方式：Cookie（SESSDATA）
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@@ -260,7 +264,7 @@ http://i2.hdslb.com/bfs/space/cb1c3ef50e22b6096fde67febe863494caefebad.png
| official_verify | obj | 认证信息2 | |
| vip | obj | 大会员状态 | |
| space | obj | 主页头图 | |
| following | bool | 是否关注此用户 | true：已关注<br />false：未关注<br />需要登录(SESSDATA) <br />未登录为false |
| following | bool | 是否关注此用户 | true：已关注<br />false：未关注<br />需要登录(Cookie) <br />未登录为false |
| archive_count | num | 用户稿件数 | |
| article_count | num | 0 | **作用尚不明确** |
| follower | num | 粉丝数 | |
@@ -419,7 +423,7 @@ curl -G 'api.bilibili.com/x/web-interface/card'\
*请求方式：GET*
需要登录(SESSDATA)
认证方式：Cookie（SESSDATA）
功能同「[登录用户信息1](../login/login_info.md#登录用户信息1（完整）)」

271
user/space.md
View File

@@ -1499,9 +1499,9 @@ curl -G 'http://api.vc.bilibili.com/link_draw/v1/doc/doc_list'\
**url参数：**
| mid | num | 目标用户UID | 必要 | |
| ------ | ---- | ----------- | ------ | ---- |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
| mid | num | 目标用户UID | 必要 | |
**json回复：**
@@ -1834,17 +1834,55 @@ curl -G 'http://api.bilibili.com/x/space/channel/video'\
认证方式：Cookie（SESSDATA）
创建成功后会返回新建频道的ID
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| name | str | 频道名 | 必要 | |
| intro | 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 'http://api.bilibili.com/x/space/channel/add'\
--data-urlencode 'name=test1'\
--data-urlencode 'intro='\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
```
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"cid": 138996
}
}
```
### 修改频道
@@ -1859,11 +1897,40 @@ curl -G 'http://api.bilibili.com/x/space/channel/video'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 频道ID | 必要 | |
| name | str | 频道名 | | |
| intro | str | 频道简介 | | |
| 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 'http://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'
```
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
### 删除频道
@@ -1877,14 +1944,39 @@ curl -G 'http://api.bilibili.com/x/space/channel/video'\
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 频道ID | 必要 | |
| 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 'http://api.bilibili.com/x/space/channel/del'\
--data-urlencode 'cid=138996'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
```
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
### 频道添加视频
> http://api.bilibili.com/x/space/channel/video/add
@@ -1892,26 +1984,70 @@ curl -G 'http://api.bilibili.com/x/space/channel/video'\
认证方式：Cookie（SESSDATA）
仅能添加自己是UP主的视频
如添加多个视频，仅会添加正确的
**注：完成后需要使用接口「查询用户频道中的视频」刷新**
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 频道ID | 必要 | |
| aids | nums | 要添加的目标视频avID | 必要 | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---------------------- |
| 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 | …… | …… |
> https://api.bilibili.com/x/space/channel/video/del
**示例：**
向频道`138995`中添加视频`av583785685`和`av243322853`
```shell
curl 'http://api.bilibili.com/x/space/channel/video/add'\
--data-urlencode 'cid=138995'\
--data-urlencode 'aids=583785685,243322853'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
```
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": []
}
```
### 频道删除视频
> http://api.bilibili.com/x/space/channel/video/del
*请求方式：POST*
认证方式：Cookie（SESSDATA）
**注：完成后需要使用接口「查询用户频道中的视频」刷新**
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@@ -1920,9 +2056,37 @@ curl -G 'http://api.bilibili.com/x/space/channel/video'\
| 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 'http://api.bilibili.com/x/space/channel/video/del'\
--data-urlencode 'cid=138995'\
--data-urlencode 'aid=583785685'\
--data-urlencode 'csrf=xxx'\
-b 'SESSDATA=xxx'
```
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
### 调整频道视频排序
> http://api.bilibili.com/x/space/channel/video/sort
@@ -1932,20 +2096,85 @@ curl -G 'http://api.bilibili.com/x/space/channel/video'\
**正文参数（ application/x-www-form-urlencoded ）：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| cid | num | 频道ID | 必要 | |
| aid | num | | 必要 | |
| to | num | | | |
| csrf | str | CSRF Token（位于cookie） | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| 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 'http://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'
```
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
### 检查频道中有无失效视频
> http://api.bilibili.com/x/space/channel/video/check
*请求方式：GET*
认证方式：Cookie（SESSDATA）
**url参数：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ---- |
| cid | num | 目标频道ID | 必要 | |
**json回复：**
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0：成功<br />-101：账号未登录<br />-111：csrf校验失败<br />-400：请求错误<br />-404：无此项<br />53005：频道内有失效视频 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
**示例：**
检查频道`138995`
```shell
curl -G 'http://api.bilibili.com/x/space/channel/video/check
--data-urlencode 'cid=138995'\
-b 'SESSDATA=xxx'
```
```json
{
"code": 0,
"message": "0",
"ttl": 1
}
```
## 收藏