优化文档格式

This commit is contained in:
社会易姐QwQ
2020-04-16 18:47:19 +08:00
parent a0c4316917
commit 4fd408f111
26 changed files with 303 additions and 149 deletions

View File

@@ -8,7 +8,7 @@
*方式:GET*
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
@@ -17,6 +17,8 @@
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误<br />-404无视频 |
@@ -204,7 +206,7 @@
| desc | str | 成员认证备注 | 无为空 |
| type | num | 成员认证类型 | -1<br />0有 |
示例:
**示例:**
http://api.bilibili.com/x/web-interface/view?aid=85440373
@@ -353,7 +355,7 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
*方式:GET*
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
@@ -362,6 +364,8 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | -------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误<br />62002稿件不可见 |
@@ -369,7 +373,7 @@ http://i0.hdslb.com/bfs/face/5387950a59be8038daaae3f66dfb5a85e20d5737.jpg
| ttl | num | 1 | 作用尚不明确 |
| data | str | 简介内容 | |
示例:
**示例:**
查看视频~~(教主的咕鸽)~~`av39330059`/`BV1Bt411z799`的简介
@@ -394,7 +398,7 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059
*方式:GET*
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
@@ -403,6 +407,8 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----- | -------- | --------------------------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误<br />-404无视频 |
@@ -439,7 +445,7 @@ http://api.bilibili.com/x/web-interface/archive/desc?aid=39330059
| height | num | 当前分P 高度 | 可能为0 |
| rotate | num | 0 | 作用尚不明确 |
示例:
**示例:**
查询视频`av13502509`/`BV1ex411J7GE`的分P列表

View File

@@ -12,7 +12,7 @@
*方式POST*
参数( application/x-www-form-urlencoded
**参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---------------------- |
@@ -23,13 +23,15 @@
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功 <br />-101账号未登录<br />-111csrf校验失败<br />-400请求错误<br />10003不存在该稿件<br />65006已赞过<br />65004取消点赞失败 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
示例:
**示例:**
为视频av79677524/BV1uJ411r7hL点赞
@@ -55,7 +57,7 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co
*方式POST*
参数( application/x-www-form-urlencoded
**参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ----------- | ---- | ------------------- | ------ | --------------------------------------- |
@@ -67,6 +69,8 @@ curl -b "SESSDATA=xxx" -d "aid=79677524&like=1&csrf=xxx" "http://api.bilibili.co
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-102账号被封停<br />-104硬币不足<br />-111csrf校验失败<br />-400请求错误<br />10003不存在该稿件<br />34002不能给自己投币<br />34003非法的投币数量<br />34005超过投币上限 |
@@ -80,7 +84,7 @@ data 对象:
| ---- | ---- | ------------ | ----------------------------------------------------- |
| like | bool | 是否点赞成功 | true成功<br />false失败<br />已赞过则附加点赞失败 |
示例:
**示例:**
为视频`av90671873`/`BV1N7411A7wC`投币2枚
@@ -111,7 +115,7 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http
需要验证referer为 `http://www.bilibili.com``https://www.bilibili.com`域名下
参数( application/x-www-form-urlencoded
**参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------- | ---- | ------------------- | ------ | ----------------------- |
@@ -123,6 +127,8 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf校验失败<br />-400请求错误<br />-403访问权限不足<br />10003不存在该稿件<br />11201已经收藏过了<br />11202已经取消收藏了<br />72010017参数错误 |
@@ -135,7 +141,7 @@ curl -b "SESSDATA=xxx" -d "aid=90671873&select_like=1&multiply=2&csrf=xxx" "http
| ------ | ---- | ----- | ------------ |
| prompt | bool | false | 作用尚不明确 |
示例:
**示例:**
将视频`av49166435`添加到收藏夹`49166435`
@@ -163,7 +169,7 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
同时点赞投币收藏视频,收藏于默认收藏夹中
参数( application/x-www-form-urlencoded
**参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ------------------ |
@@ -173,6 +179,8 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-111csrf校验失败<br />-400请求错误<br />10003不存在该稿件 |
@@ -189,7 +197,7 @@ curl --referer "http://www.bilibili.com" -b "SESSDATA=xxx" -d "rid=90671873&type
| fav | bool | 是否收藏成功 | |
| multiply | num | 投币枚数 | 默认为2 |
示例:
**示例:**
将视频`av91003840`/`BV1Wj411f79U`一键三连
@@ -223,7 +231,7 @@ curl -b "SESSDATA=xxx" -d "aid=91003840&csrf=xxx" "http://api.bilibili.com/x/web
*方式:GET*
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------ | ------ | ---- |
@@ -231,6 +239,8 @@ curl -b "SESSDATA=xxx" -d "aid=91003840&csrf=xxx" "http://api.bilibili.com/x/web
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误<br />-101账号未登录 |
@@ -245,7 +255,7 @@ data 对象:
| count | num | 1 | 作用尚不明确 |
| favoured | bool | 是否收藏 | true已收藏<br />false未收藏 |
示例:
**示例:**
视频`av46281123`/`BV1Bb411H7Dv`的状态为已收藏
@@ -275,7 +285,7 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123
*方式:GET*
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
@@ -284,6 +294,8 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | ---------- | ------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误<br />-101账号未登录 |
@@ -291,7 +303,7 @@ http://api.bilibili.com/x/v2/fav/video/favoured?aid=46281123
| ttl | num | 1 | 作用尚不明确 |
| data | num | 被点赞标志 | 0未点赞<br />1已点赞 |
示例:
**示例:**
视频`av39330059`/`BV1Bt411z799`的状态为已点赞
@@ -318,7 +330,7 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
*方式:GET*
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
@@ -327,6 +339,8 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误<br />-101账号未登录 |
@@ -340,7 +354,7 @@ http://api.bilibili.com/x/web-interface/archive/has/like?aid=39330059
| -------- | ---- | -------- | --------- |
| multiply | num | 投币枚数 | 未投币为0 |
示例:
**示例:**
视频`av37896701`/`BV18t411q7zz`的投币数为2枚

View File

@@ -8,7 +8,7 @@
最多获取40条推荐视频
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
@@ -17,6 +17,8 @@
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ---------------------------- |
| code | num | 返回值 | 0成功 <br />-400请求错误 |
@@ -37,7 +39,7 @@
基本同「[视频详细信息](info.md#视频详细信息)」中的data对象
示例:
**示例:**
查询视频`av7`/`BV1xx411c7m9`的推荐视频列表

View File

@@ -11,7 +11,8 @@
*方式:GET*
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------ | ------ | ----------------------------------- |
| aid | url | 视频avID | 非必要 | avID与bvID任选一个 |
@@ -21,6 +22,8 @@
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------ |
| code | num | 返回值 | 0成功 <br />40001请求错误<br />40003无视频 |
@@ -57,7 +60,7 @@
| n | num | 图片n 截取时间 | 单位为秒 |
| …… | num | …… | 单位为秒 |
示例:
**示例:**
http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1
@@ -90,12 +93,16 @@ http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1
内容与「获取视频快照1」加参数「index」=1相同但url带有转义仅限第1P
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| aid | url | 视频avID | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------------------------------- |
| code | num | 返回值 | 0成功<br />40001请求错误<br />-404无视频 |
@@ -132,7 +139,7 @@ http://api.bilibili.com/x/player/videoshot?aid=26273789&index=1
| n | num | 图片n 截取时间 | 单位为秒 |
| …… | num | …… | 单位为秒 |
示例:
**示例:**
http://api.bilibili.com/pvideo?aid=26273789

View File

@@ -5,13 +5,16 @@
*方式:GET*
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| aid | url | 视频avID | 必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------------------------- |
| code | num | 返回值 | 0成功<br />40001请求错误<br />40003无视频 |
@@ -37,7 +40,7 @@
| no_reprint | num | 禁止转载标志 | 0<br />1禁止 |
| copyright | num | 版权标志 | 1自制<br />2转载 |
示例:
**示例:**
查询视频`av91572143`的状态数
@@ -80,7 +83,8 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143
**此API克pythonUA中只要存在\*python\*字眼就无法获取正确内容如用py请改UA**
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ------------------ |
| aid | url | 视频avID | 非必要 | avID与bvID任选一个 |
@@ -88,6 +92,8 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----------------------------------------------- |
| code | num | 返回值 | 0成功 <br />-400请求错误<br />40003无视频 |
@@ -116,7 +122,7 @@ http://api.bilibili.com/archive_stat/stat?aid=91572143
| argue_msg | str | 警告信息 | 默认为空 |
| evaluation | str | 视频评分 | 默认为空 |
示例:
**示例:**
查询视频`av2271112`/`BV1es411D7sW`的状态数