mirror of
https://github.com/SocialSisterYi/bilibili-API-collect.git
synced 2025-01-14 22:00:07 +08:00
继续修改文档格式 补完频道相关接口
This commit is contained in:
parent
33f693dd41
commit
26560f16d9
@ -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"/>
|
||||
|
||||
|
@ -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`对象:
|
||||
|
||||
|
@ -514,7 +514,7 @@ curl 'http://api.bilibili.com/x/member/web/coin/log'\
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ------- | ---- | -------- | ------------------------------------------------------------ |
|
||||
| code | num | 返回值 | 0:成功<br />-101:账号未登录<br />-111:csrf校验失败<br />40022:签名过长 |
|
||||
| code | num | 返回值 | 0:成功<br />-101:账号未登录<br />-111:csrf校验失败<br />40015:签名包含敏感词<br />40021:签名不能包含表情图片<br />40022:签名过长 |
|
||||
| message | str | 错误信息 | 默认为0 |
|
||||
| ttl | num | 1 | 作用尚不明确 |
|
||||
|
||||
|
@ -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
|
||||
}
|
||||
}
|
||||
```
|
||||
|
@ -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
|
||||
{
|
||||
|
@ -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
|
||||
{
|
||||
|
@ -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
|
||||
{
|
||||
|
@ -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
|
||||
{
|
||||
|
@ -31,7 +31,9 @@
|
||||
|
||||
**示例:**
|
||||
|
||||
http://api.bilibili.com/x/web-interface/zone
|
||||
```shell
|
||||
curl 'http://api.bilibili.com/x/web-interface/zone'
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
|
@ -23,7 +23,9 @@
|
||||
|
||||
**示例:**
|
||||
|
||||
http://api.bilibili.com/x/report/click/now
|
||||
```shell
|
||||
curl 'http://api.bilibili.com/x/report/click/now'
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
|
@ -50,7 +50,9 @@
|
||||
|
||||
**示例:**
|
||||
|
||||
http://api.bilibili.com/x/web-interface/online
|
||||
```shell
|
||||
curl 'http://api.bilibili.com/x/web-interface/online'
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
|
@ -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
|
||||
{
|
||||
|
@ -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
|
||||
{
|
||||
|
@ -6,14 +6,16 @@
|
||||
|
||||
*请求方式:GET*
|
||||
|
||||
认证方式:Cookie(SESSDATA)
|
||||
|
||||
根据关键词进行搜索,返回结果每页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
|
||||
{
|
||||
|
12
user/info.md
12
user/info.md
@ -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
271
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:成功<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
|
||||
}
|
||||
```
|
||||
|
||||
## 收藏
|
||||
|
||||
|
@ -2,7 +2,7 @@
|
||||
|
||||
**本页所有操作均需登录(Cookie或APP)**
|
||||
|
||||
## 上报观看进度(APP端)
|
||||
## 上报观看进度(双端)
|
||||
|
||||
> http://api.bilibili.com/x/v2/history/report
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user