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

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

View File

@ -4,16 +4,18 @@ web端流程&逻辑:
1. 获取`二维码内容url`以及`密钥`,以`二维码内容url`生成二维码,等待手机客户端扫描
2. 以`密钥`作为参数进行POST
3. if "code"==true goto 6 else goto 4是否已经确认
4. if "data"==-4 goto 2 else goto 5是否已经扫描
5. if "data"==-5 goto 3 && 提示`已扫描`else goto 1&提示`二维码超时或错误`(密钥是否有效)
3. if `code` == `true` goto `6` else goto 4是否已经确认
4. if `data` == `-4` goto `2` else goto 5是否已经扫描
5. if `data` == `-5` goto `3` & 提示`已扫描` else goto `1`&提示`二维码超时或错误`(密钥是否有效)
6. 成功后会自动配置cookie 如需登录游戏分站则访问`data`.`url`中的url
TV端流程&逻辑:
1. 获取`二维码内容url`以及`密钥`,以`二维码内容url`生成二维码,等待手机客户端扫描
2. 以`密钥`作为参数进行POST
3.
3. if `code` == `0` 提示`扫码成功`并存储`access_key`于`refersh_key` else goto `4`
4. if `code` == `86039` 提示`未扫描`&goto `2` else goto `5`
5. if `code` == `86038` 提示`二维码超时或错误`&goto `1`
<img src="/imgs/2233login.png"/>

View File

@ -289,26 +289,26 @@ curl 'http://account.bilibili.com/home/userInfo'\
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ------------------------ |
| mid | num | 用户UID | |
| name | str | 用户昵称 | |
| sign | str | 用户签名 | |
| coins | num | 拥有硬币数 | |
| birthday | str | 用户生日 | YYYY-MM-DD |
| face | str | 用户头像url | |
| sex | num | 用户性别 | 1 |
| level | num | 用户等级 | 0-6 |
| rank | num | 1000 | **作用尚不明确** |
| silence | num | 用户是否被封禁 | 0正常<br />1封禁 |
| vip | obj | 会员信息 | |
| email_status | num | 是否验证邮箱地址 | 0未验证<br />1已验证 |
| tel_status | num | 是否验证手机号 | 0未验证<br />1已验证 |
| official | obj | 认证信息 | |
| identification | num | 1 | **作用尚不明确** |
| invite | obj | | |
| is_tourist | num | 0 | **作用尚不明确** |
| pin_prompting | num | 0 | **作用尚不明确** |
| 字段 | 类型 | 内容 | 备注 |
| -------------- | ---- | ---------------- | ----------------------------- |
| mid | num | 用户UID | |
| name | str | 用户昵称 | |
| sign | str | 用户签名 | |
| coins | num | 拥有硬币数 | |
| birthday | str | 用户生日 | YYYY-MM-DD |
| face | str | 用户头像url | |
| sex | num | 用户性别 | 1<br />2<br />3私密 |
| level | num | 用户等级 | 0-6 |
| rank | num | 1000 | **作用尚不明确** |
| silence | num | 用户是否被封禁 | 0正常<br />1封禁 |
| vip | obj | 会员信息 | |
| email_status | num | 是否验证邮箱地址 | 0未验证<br />1已验证 |
| tel_status | num | 是否验证手机号 | 0未验证<br />1已验证 |
| official | obj | 认证信息 | |
| identification | num | 1 | **作用尚不明确** |
| invite | obj | | |
| is_tourist | num | 0 | **作用尚不明确** |
| pin_prompting | num | 0 | **作用尚不明确** |
`data`中的`vip`对象:

View File

@ -514,7 +514,7 @@ curl 'http://api.bilibili.com/x/member/web/coin/log'\
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf校验失败<br />40022签名过长 |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf校验失败<br />40015签名包含敏感词<br />40021签名不能包含表情图片<br />40022签名过长 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |

View File

@ -30,11 +30,11 @@ data 对象:
| like | num | 未读点赞数 | |
| reply | num | 未读回复数 | |
| sys_msg | num | 未读系统通知数 | |
| up | num | 0 | 作用尚不明确 |
| up | num | UP主助手信息数 | |
**示例:**
以下信息代表了未读点赞数为10未读回复数为3未读at消息数为1未读系统通知数为1
以下信息代表了未读点赞数为10未读回复数为4未读at消息数为3未读系统通知数为2UP主助手信息数为1
```shell
curl 'http://api.bilibili.com/x/msgfeed/unread'\
@ -47,12 +47,12 @@ curl 'http://api.bilibili.com/x/msgfeed/unread'\
"message": "0",
"ttl": 1,
"data": {
"at": 1,
"at": 3,
"chat": 0,
"like": 10,
"reply": 3,
"sys_msg": 1,
"up": 0
"reply": 4,
"sys_msg": 2,
"up": 1
}
}
```

View File

@ -1,6 +1,6 @@
# 音频投币&收藏
**本页所有操作均需登录SESSDATA以及DedeUserID存在且不为0**
本页所有操作均需登录SESSDATA
## 查询音频收藏状态
@ -8,6 +8,10 @@
*请求方式GET*
认证方式CookieSESSDATA
鉴权方式Cookie中`DedeUserID`存在且不为0
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@ -28,7 +32,11 @@
查询音频`au13598`的收藏状态
http://www.bilibili.com/audio/music-service-c/web/collections/songs-coll?sid=13598
```shell
curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/songs-coll'\
--data-urlencode 'sid=13598'\
-b 'SESSDATA=xxx;DedeUserID=1;'
```
```json
{
@ -38,14 +46,16 @@ http://www.bilibili.com/audio/music-service-c/web/collections/songs-coll?sid=135
}
```
## 查询音频投币数
> http://www.bilibili.com/audio/music-service-c/web/coin/audio
*请求方式GET*
认证方式CookieSESSDATA
鉴权方式Cookie中`DedeUserID`存在且不为0
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@ -66,7 +76,11 @@ http://www.bilibili.com/audio/music-service-c/web/collections/songs-coll?sid=135
查询音频`au13598`的投币数
http://www.bilibili.com/audio/music-service-c/web/coin/audio?sid=15664
```shell
curl -G 'http://www.bilibili.com/audio/music-service-c/web/coin/audio'\
--data-urlencode 'sid=15664'\
-b 'SESSDATA=xxx;DedeUserID=1;'
```
```json
{

View File

@ -6,6 +6,8 @@
*请求方式GET*
认证方式CookieSESSDATA
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
@ -83,7 +85,11 @@
查询音频`au13598`的基本信息
http://www.bilibili.com/audio/music-service-c/web/song/info?sid=13598
```shell
curl -G 'http://www.bilibili.com/audio/music-service-c/web/song/info'\
--data-urlencode 'sid=13598'\
-b 'SESSDATA=xxx'
```
```json
{
@ -132,8 +138,6 @@ http://www.bilibili.com/audio/music-service-c/web/song/info?sid=13598
}
```
## 查询歌曲TAG
> http://www.bilibili.com/audio/music-service-c/web/tag/song
@ -177,7 +181,10 @@ http://www.bilibili.com/audio/music-service-c/web/song/info?sid=13598
查询音频`au15664`的TAG
http://www.bilibili.com/audio/music-service-c/web/tag/song?sid=15664
```shell
curl -G 'http://www.bilibili.com/audio/music-service-c/web/tag/song'\
--data-urlencode 'sid=15664'
```
```json
{
@ -224,8 +231,6 @@ http://www.bilibili.com/audio/music-service-c/web/tag/song?sid=15664
}
```
## 查询歌曲创作成员列表
> http://www.bilibili.com/audio/music-service-c/web/member/song
@ -283,7 +288,10 @@ http://www.bilibili.com/audio/music-service-c/web/tag/song?sid=15664
查询音频`au815861`的创作成员信息
http://www.bilibili.com/audio/music-service-c/web/member/song?sid=815861
```shell
curl -G 'http://www.bilibili.com/audio/music-service-c/web/member/song'\
--data-urlencode 'sid=815861'
```
```json
{
@ -354,8 +362,6 @@ http://www.bilibili.com/audio/music-service-c/web/member/song?sid=815861
}
```
## 获取歌曲歌词
> http://www.bilibili.com/audio/music-service-c/web/song/lyric
@ -384,7 +390,11 @@ http://www.bilibili.com/audio/music-service-c/web/member/song?sid=815861
获取音频`au15664`的歌词信息
http://www.bilibili.com/audio/music-service-c/web/song/lyric?sid=15664
```shell
curl -G 'http://www.bilibili.com/audio/music-service-c/web/song/lyric'\
--data-urlencode 'sid=15664'\
-b 'SESSDATA=xxx'
```
```json
{

View File

@ -6,7 +6,9 @@
*请求方式GET*
需要登录(SESSDATA)及验证DedeUserID存在且不为0
认证方式CookieSESSDATA
鉴权方式Cookie中`DedeUserID`存在且不为0
**url参数**
@ -81,7 +83,12 @@
**示例:**
http://www.bilibili.com/audio/music-service-c/web/collections/list?pn=1&ps=2
```shell
curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/list'\
--data-urlencode 'ps=2'\
--data-urlencode 'pn=1'\
-b 'SESSDATA=xxx;DedeUserID=1;'
```
共计创建了两个歌单,如下
@ -156,15 +163,15 @@
}
```
## 查询音频收藏夹(默认歌单)信息
> https://www.bilibili.com/audio/music-service-c/web/collections/info
*请求方式GET*
需要登录(SESSDATA)及验证DedeUserID存在且不为0
认证方式CookieSESSDATA
鉴权方式Cookie中`DedeUserID`存在且不为0
**url参数**
@ -222,7 +229,11 @@
查询我的默认歌单ID为` 15967839 `
https://www.bilibili.com/audio/music-service-c/web/collections/info?sid=15967839
```shell
curl -G 'http://www.bilibili.com/audio/music-service-c/web/collections/info'\
--data-urlencode 'sid=15967839 '\
-b 'SESSDATA=xxx;DedeUserID=1;'
```
```json
{

View File

@ -38,7 +38,10 @@
查询歌曲`au15664`的状态数
http://www.bilibili.com/audio/music-service-c/web/stat/song?sid=15664
```shell
curl -G 'http://www.bilibili.com/audio/music-service-c/web/stat/song'\
--data-urlencode 'sid=15664'
```
```json
{

View File

@ -31,7 +31,9 @@
**示例:**
http://api.bilibili.com/x/web-interface/zone
```shell
curl 'http://api.bilibili.com/x/web-interface/zone'
```
```json
{

View File

@ -23,7 +23,9 @@
**示例:**
http://api.bilibili.com/x/report/click/now
```shell
curl 'http://api.bilibili.com/x/report/click/now'
```
```json
{

View File

@ -50,7 +50,9 @@
**示例:**
http://api.bilibili.com/x/web-interface/online
```shell
curl 'http://api.bilibili.com/x/web-interface/online'
```
```json
{

View File

@ -56,7 +56,13 @@
获取`tID=21`(生活->日常分区中的2条最新动态视频信息
https://api.bilibili.com/x/web-interface/dynamic/region?pn=1&ps=2&rid=21
```shell
curl -G 'http://api.bilibili.com/x/web-interface/dynamic/region'\
--data-urlencode 'rid=21'\
--data-urlencode 'ps=2'\
--data-urlencode 'pn=1'\
-b 'SESSDATA=xxx'
```
```json
{

View File

@ -45,7 +45,11 @@
获取`tID=1`(动画)分区中的三日视频排行榜
http://api.bilibili.com/x/web-interface/ranking/region?rid=1&day=3
```shell
curl -G 'http://api.bilibili.com/x/web-interface/ranking/region'\
--data-urlencode 'rid=1'\
--data-urlencode 'day=3'
```
```json
{

View File

@ -6,14 +6,16 @@
*请求方式GET*
认证方式CookieSESSDATA
根据关键词进行搜索返回结果每页20项
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
| keyword | str | 需要搜索的关键词 | 必要 | |
| search_type | str | 搜索目标类型 | 必要 | 视频video<br/>番剧media_bangumi<br/>影视media_ft<br/>直播间及主播live<br />直播间live_room<br/>主播live_user<br/>专栏article<br/>话题topic<br/>用户bili_user<br/>相簿photo |
| keyword | str | 需要搜索的关键词 | 必要 | |
| order | str | 结果排序方式 | 非必要 | 搜索类型为视频、专栏及相簿时:<br />默认为totalrank<br />综合排序totalrank<br/>最多点击click<br/>最新发布pubdate<br/>最多弹幕dm<br/>最多收藏stow<br/>最多评论scores<br />最多喜欢attention仅用于专栏<br />----------------------------<br/>搜索结果为直播间时:<br />默认为online<br />人气直播online<br/>最新开播live_time<br />----------------------------<br/>搜索结果为用户时:<br />默认为0<br />默认排序0<br/>粉丝数fans<br/>用户等级level |
| order_sort | num | 用户粉丝数及等级排序顺序 | 非必要 | 仅用于搜索用户<br />默认为0<br />由高到低0<br/>由低到高1 |
| user_type | num | 用户分类筛选 | 非必要 | 仅用于搜索用户<br />默认为0<br />全部用户0<br/>up主1<br/>普通用户2<br/>认证用户3 |
@ -120,7 +122,16 @@
按照关键词` 少年 `搜索视频默认排序全部时长全部分区第1页
http://api.bilibili.com/x/web-interface/search/type?keyword=少年&search_type=video&order=totalrank&duration=0&page=1&tids=0
```shell
curl -G 'http://api.bilibili.com/x/web-interface/search/type'\
--data-urlencode 'search_type=video'\
--data-urlencode 'keyword=少年'\
--data-urlencode 'order=totalrank'\
--data-urlencode 'duration=0'\
--data-urlencode 'tids=0'\
--data-urlencode 'page=1'\
-b 'SESSDATA=xxx'
```
```json
{

View File

@ -7,6 +7,8 @@
*请求方式GET*
认证方式CookieSESSDATA
**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*
认证方式CookieSESSDATA
**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)
认证方式CookieSESSDATA
功能同「[登录用户信息1](../login/login_info.md#登录用户信息1完整)」

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'\
认证方式CookieSESSDATA
创建成功后会返回新建频道的ID
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------------ | ------ | ---- |
| name | str | 频道名 | 必要 | |
| intro | str | 频道简介 | | |
| intro | str | 频道简介 | 非必要 | |
| csrf | str | CSRF Token位于cookie | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf校验失败<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 />-111csrf校验失败<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 />-111csrf校验失败<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'\
认证方式CookieSESSDATA
仅能添加自己是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 />-111csrf校验失败<br />-400请求错误<br />-404无此项<br />53003本频道里的视频已满<br />53006提交视频已失效或频道里有非该视频UP主 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | array | 出错视频avID列表 | |
`data`数组:
### 删除频道视频
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | ------------------- | ---- |
| 0 | num | 出错视频avID1 | |
| n | num | 出错视频avIDn+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*
认证方式CookieSESSDATA
**注:完成后需要使用接口「查询用户频道中的视频」刷新**
**正文参数( 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 />-111csrf校验失败<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 />-111csrf校验失败<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*
认证方式CookieSESSDATA
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---------- | ------ | ---- |
| cid | num | 目标频道ID | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf校验失败<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
}
```
## 收藏

View File

@ -2,7 +2,7 @@
**本页所有操作均需登录Cookie或APP**
## 上报观看进度(APP端)
## 上报观看进度(端)
> http://api.bilibili.com/x/v2/history/report