diff --git a/login/login_action/QR.md b/login/login_action/QR.md index 36b73e7..1db3bf3 100644 --- a/login/login_action/QR.md +++ b/login/login_action/QR.md @@ -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` diff --git a/login/login_info.md b/login/login_info.md index 47a3508..0563290 100644 --- a/login/login_info.md +++ b/login/login_info.md @@ -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:正常
1:封禁 | -| vip | obj | 会员信息 | | -| email_status | num | 是否验证邮箱地址 | 0:未验证
1:已验证 | -| tel_status | num | 是否验证手机号 | 0:未验证
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:男
2:女
3:私密 | +| level | num | 用户等级 | 0-6 | +| rank | num | 1000 | **作用尚不明确** | +| silence | num | 用户是否被封禁 | 0:正常
1:封禁 | +| vip | obj | 会员信息 | | +| email_status | num | 是否验证邮箱地址 | 0:未验证
1:已验证 | +| tel_status | num | 是否验证手机号 | 0:未验证
1:已验证 | +| official | obj | 认证信息 | | +| identification | num | 1 | **作用尚不明确** | +| invite | obj | | | +| is_tourist | num | 0 | **作用尚不明确** | +| pin_prompting | num | 0 | **作用尚不明确** | `data`中的`vip`对象: diff --git a/login/member_center.md b/login/member_center.md index d357228..8fcbc54 100644 --- a/login/member_center.md +++ b/login/member_center.md @@ -514,7 +514,7 @@ curl 'http://api.bilibili.com/x/member/web/coin/log'\ | 字段 | 类型 | 内容 | 备注 | | ------- | ---- | -------- | ------------------------------------------------------------ | -| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf校验失败
40022:签名过长 | +| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf校验失败
40015:签名包含敏感词
40021:签名不能包含表情图片
40022:签名过长 | | message | str | 错误信息 | 默认为0 | | ttl | num | 1 | 作用尚不明确 | diff --git a/message/msg.md b/message/msg.md index bdd0d99..696f494 100644 --- a/message/msg.md +++ b/message/msg.md @@ -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,未读系统通知数为2,UP主助手信息数为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 } } ``` diff --git a/music/coin&fav.md b/music/coin&fav.md index 38e50be..c186a0d 100644 --- a/music/coin&fav.md +++ b/music/coin&fav.md @@ -1,6 +1,6 @@ # 音频投币&收藏 -**本页所有操作均需登录(SESSDATA)以及DedeUserID存在且不为0** +本页所有操作均需登录(SESSDATA) ## 查询音频收藏状态 @@ -8,6 +8,10 @@ *请求方式:GET* +认证方式:Cookie(SESSDATA) + +鉴权方式: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* +认证方式:Cookie(SESSDATA) + +鉴权方式: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 { diff --git a/music/info.md b/music/info.md index d039a7a..ce8744c 100644 --- a/music/info.md +++ b/music/info.md @@ -6,6 +6,8 @@ *请求方式:GET* +认证方式:Cookie(SESSDATA) + **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 { diff --git a/music/music_list.md b/music/music_list.md index d75c350..461c926 100644 --- a/music/music_list.md +++ b/music/music_list.md @@ -6,7 +6,9 @@ *请求方式:GET* -需要登录(SESSDATA)及验证DedeUserID存在且不为0 +认证方式:Cookie(SESSDATA) + +鉴权方式: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 +认证方式:Cookie(SESSDATA) + +鉴权方式: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 { diff --git a/music/status_number.md b/music/status_number.md index 8bcdaaa..48ea29d 100644 --- a/music/status_number.md +++ b/music/status_number.md @@ -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 { diff --git a/other/ip.md b/other/ip.md index f710b7e..cdb531c 100644 --- a/other/ip.md +++ b/other/ip.md @@ -31,7 +31,9 @@ **示例:** -http://api.bilibili.com/x/web-interface/zone +```shell +curl 'http://api.bilibili.com/x/web-interface/zone' +``` ```json { diff --git a/other/time_stamp.md b/other/time_stamp.md index ea7c5ff..f3e7a84 100644 --- a/other/time_stamp.md +++ b/other/time_stamp.md @@ -23,7 +23,9 @@ **示例:** -http://api.bilibili.com/x/report/click/now +```shell +curl 'http://api.bilibili.com/x/report/click/now' +``` ```json { diff --git a/other/zone_online.md b/other/zone_online.md index a16b150..0cdbd1e 100644 --- a/other/zone_online.md +++ b/other/zone_online.md @@ -50,7 +50,9 @@ **示例:** -http://api.bilibili.com/x/web-interface/online +```shell +curl 'http://api.bilibili.com/x/web-interface/online' +``` ```json { diff --git a/ranking&dynamic/dynamic.md b/ranking&dynamic/dynamic.md index f8af7ce..45b7311 100644 --- a/ranking&dynamic/dynamic.md +++ b/ranking&dynamic/dynamic.md @@ -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 { diff --git a/ranking&dynamic/ranking.md b/ranking&dynamic/ranking.md index aadd3f9..bac1031 100644 --- a/ranking&dynamic/ranking.md +++ b/ranking&dynamic/ranking.md @@ -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 { diff --git a/search/search_request.md b/search/search_request.md index 5bafa28..54b5c70 100644 --- a/search/search_request.md +++ b/search/search_request.md @@ -6,14 +6,16 @@ *请求方式:GET* +认证方式:Cookie(SESSDATA) + 根据关键词进行搜索,返回结果每页20项 **url参数:** | 参数名 | 类型 | 内容 | 必要性 | 备注 | | ----------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ | -| keyword | str | 需要搜索的关键词 | 必要 | | | search_type | str | 搜索目标类型 | 必要 | 视频:video
番剧:media_bangumi
影视:media_ft
直播间及主播:live
直播间:live_room
主播:live_user
专栏:article
话题:topic
用户:bili_user
相簿:photo | +| keyword | str | 需要搜索的关键词 | 必要 | | | order | str | 结果排序方式 | 非必要 | 搜索类型为视频、专栏及相簿时:
默认为totalrank
综合排序:totalrank
最多点击:click
最新发布:pubdate
最多弹幕:dm
最多收藏:stow
最多评论:scores
最多喜欢:attention(仅用于专栏)
----------------------------
搜索结果为直播间时:
默认为online
人气直播:online
最新开播:live_time
----------------------------
搜索结果为用户时:
默认为0
默认排序:0
粉丝数:fans
用户等级:level | | order_sort | num | 用户粉丝数及等级排序顺序 | 非必要 | 仅用于搜索用户
默认为0
由高到低:0
由低到高:1 | | user_type | num | 用户分类筛选 | 非必要 | 仅用于搜索用户
默认为0
全部用户:0
up主:1
普通用户:2
认证用户: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 { diff --git a/user/info.md b/user/info.md index af66df0..f596037 100644 --- a/user/info.md +++ b/user/info.md @@ -7,6 +7,8 @@ *请求方式:GET* +认证方式:Cookie(SESSDATA) + **url参数:** | 参数名 | 类型 | 内容 | 必要性 | 备注 | @@ -39,13 +41,13 @@ | moral | num | 0 | **作用尚不明确** | | silence | num | 封禁状态 | 0:正常
1:被封 | | birthday | str | 生日 | MM-DD | -| coins | num | 硬币数 | 需要登录(SESSDATA)
只能查看自己的
默认为0 | +| coins | num | 硬币数 | 需要登录(Cookie)
只能查看自己的
默认为0 | | fans_badge | bool | 是否具有粉丝勋章 | false:无
true:有 | | official | obj | 认证信息 | | | vip | obj | 大会员信息 | | | pendant | obj | 头像框信息 | | | nameplate | obj | 勋章信息 | | -| is_followed | bool | 是否关注此用户 | true:已关注
false:未关注
需要登录(SESSDATA)
未登录恒为false | +| is_followed | bool | 是否关注此用户 | true:已关注
false:未关注
需要登录(Cookie)
未登录恒为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:已关注
false:未关注
需要登录(SESSDATA)
未登录为false | +| following | bool | 是否关注此用户 | true:已关注
false:未关注
需要登录(Cookie)
未登录为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(完整))」 diff --git a/user/space.md b/user/space.md index 71cac60..334265f 100644 --- a/user/space.md +++ b/user/space.md @@ -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:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
53001:频道名字数超过限制
53002:频道简介字数超过限制
53004:创建的频道已经满额
53007:频道名称已经存在
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:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
53001:频道名字数超过限制
53002:频道简介字数超过限制
53007:频道名称已经存在
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:成功
-101:账号未登录
-111:csrf校验失败
-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:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
-404:无此项
53003:本频道里的视频已满
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:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
-404:无此项
53008:频道内没有视频
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
1为列表底部,视频总数为首端
与显示顺序恰好相反 | +| csrf | str | CSRF Token(位于cookie) | 必要 | | +**json回复:** +根对象: +| 字段 | 类型 | 内容 | 备注 | +| ------- | ---- | -------- | ------------------------------------------------------------ | +| code | num | 返回值 | 0:成功
-101:账号未登录
-111:csrf校验失败
-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:成功
-101:账号未登录
-111:csrf校验失败
-400:请求错误
-404:无此项
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 +} +``` ## 收藏 diff --git a/video/report.md b/video/report.md index 7a0ad31..16f432b 100644 --- a/video/report.md +++ b/video/report.md @@ -2,7 +2,7 @@ **本页所有操作均需登录(Cookie或APP)** -## 上报观看进度(APP端) +## 上报观看进度(双端) > http://api.bilibili.com/x/v2/history/report