优化文档格式

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

@@ -10,7 +10,7 @@
登录(SESSDATA)可看自己全部
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | -------------------------------- |
@@ -20,6 +20,8 @@
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误<br />22007访问超过5页 |
@@ -84,7 +86,7 @@
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
示例:
**示例:**
以每页2项的方式获取`UID=293793435`的用户的第1页的粉丝明细
@@ -165,7 +167,7 @@ http://api.bilibili.com/x/relation/followers?vmid=293793435&ps=2&pn=1
登录(SESSDATA)可看自己全部
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | -------------------------------- |
@@ -175,6 +177,8 @@ http://api.bilibili.com/x/relation/followers?vmid=293793435&ps=2&pn=1
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | --------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-400请求错误<br />22007访问超过5页 |
@@ -247,7 +251,7 @@ data 对象:
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
示例:
**示例:**
以每页2项的方式获取`UID=293793435`的用户的第1页的关注明细
@@ -328,16 +332,16 @@ http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1
需要登录(SESSDATA)
参数( application/x-www-form-urlencoded
**参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---- |
| fid | data | 目标用户UID | 必要 | |
| act | data | 操作代码 | 必要 | |
| re_src | data | 必须为11 | 必要 | |
| csrf | data | cookies中的bili_jct | 必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | -------------- |
| fid | data | 目标用户UID | 必要 | |
| act | data | 操作代码 | 必要 | 操作代码见下表 |
| re_src | data | 必须为11 | 必要 | |
| csrf | data | cookies中的bili_jct | 必要 | |
操作代码:
操作代码`act`
| 代码 | 含义 |
| ---- | ------------ |
@@ -351,13 +355,15 @@ http://api.bilibili.com/x/relation/followings?vmid=293793435&ps=2&pn=1
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-102账号被封停<br />-111csrf校验失败<br />-400请求错误<br />22003用户位于黑名单 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
示例:
**示例:**
关注`UID=14082`的用户
@@ -381,7 +387,7 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili
需要登录(SESSDATA)
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@@ -389,6 +395,8 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-400请求错误 |
@@ -414,7 +422,7 @@ curl -b SESSDATA=xxx -d "fid=14082&act=1&re_src=11&csrf=xxx" http://api.bilibili
| n | num | 位于分组n+1的分组ID | |
| …… | num | …… | …… |
示例:
**示例:**
可得对于`UID=258150656`的用户,在`2018/10/28 0:51:41`时关注且设为特别关注并位于ID为`-10`分组中
@@ -445,7 +453,7 @@ http://api.bilibili.com/x/relation?fid=258150656
需要登录(SESSDATA)
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@@ -453,6 +461,8 @@ http://api.bilibili.com/x/relation?fid=258150656
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-400请求错误 |
@@ -495,7 +505,7 @@ http://api.bilibili.com/x/relation?fid=258150656
| n | num | 位于分组n+1的分组ID | |
| …… | num | …… | …… |
示例:
**示例:**
可得对于`UID=15858903`的用户,在`2019/1/24 14:24:19`时关注了对方且互相关注自己将对方特别关注并同时位于ID为`-10``194110`的分组中对方也将自己设为特别关注并同时位于ID为`-10``56502`的分组中(虽然我看不到)
@@ -541,6 +551,8 @@ http://api.bilibili.com/x/space/acc/relation?mid=15858903
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ----------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录 |
@@ -565,7 +577,7 @@ http://api.bilibili.com/x/space/acc/relation?mid=15858903
| name | str | 分组名称 | |
| count | num | 分组成员数 | |
示例:
**示例:**
查询所有的分组的名字以及ID
@@ -604,7 +616,7 @@ http://api.bilibili.com/x/relation/tags
需要登录(SESSDATA)
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---------------------------------- |
@@ -614,6 +626,8 @@ http://api.bilibili.com/x/relation/tags
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------ | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-400请求错误<br />22104该分组不存在<br />-101账号未登录 |
@@ -666,7 +680,7 @@ http://api.bilibili.com/x/relation/tags
| ---- | ---- | ---- | ------------ |
| path | str | 空 | 作用尚不明确 |
示例:
**示例:**
以每页2项的方式获取了ID为`207542`分组的第1页的粉丝明细
@@ -733,7 +747,7 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1
需要登录(SESSDATA)
参数:
**参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ----------- | ------ | ---- |
@@ -741,6 +755,8 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-101账号未登录<br />-400请求错误 |
@@ -756,7 +772,7 @@ http://api.bilibili.com/x/relation/tag?tagid=207542&ps=2&pn=1
| 加入的分组ID n | str | 分组n名称 | |
| …… | str | …… | |
示例:
**示例:**
查询用户`UID=319214221`存在的所有分组ID和名称
@@ -786,7 +802,7 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221
需要登录(SESSDATA)
参数( application/x-www-form-urlencoded
**参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---------- |
@@ -795,6 +811,8 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22106该分组已经存在<br />22103分组名过长 |
@@ -808,7 +826,7 @@ http://api.bilibili.com/x/relation/tag/user?fid=319214221
| ----- | ---- | -------------- | ---- |
| tagid | num | 创建的分组的ID | |
示例:
**示例:**
创建了名为`vUP`的分组得到ID为`216677`
@@ -835,7 +853,7 @@ curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" http://api.bilibili.com/x/relation/ta
需要登录(SESSDATA)
参数( application/x-www-form-urlencoded
**参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---------- |
@@ -845,13 +863,15 @@ curl -b SESSDATA=xxx -d "tag=vUP&csrf=xxx" http://api.bilibili.com/x/relation/ta
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22103分组名过长<br />22104该分组不存在 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
示例:
**示例:**
把ID为`194112`的分组更名为`膜法师`
@@ -877,7 +897,7 @@ curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx"
需要登录(SESSDATA)
参数( application/x-www-form-urlencoded
**参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | ---- |
@@ -886,6 +906,8 @@ curl -b SESSDATA=xxx -d "tagid=194112&name=%e8%86%9c%e6%b3%95%e5%b8%88&csrf=xxx"
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误 |
@@ -918,7 +940,7 @@ curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" http://api.bilibili.com/x/relati
需要登录(SESSDATA)
参数( application/x-www-form-urlencoded
**参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | -------------------------- |
@@ -928,13 +950,15 @@ curl -b SESSDATA=xxx -d "tagid=216699&csrf=xxx" http://api.bilibili.com/x/relati
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22104无权限<br />22105未关注 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
示例:
**示例:**
把关注用户`UID=205631797`同时添加分组关系到ID为`-10``207542`的分组中
@@ -958,7 +982,7 @@ curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" http://api
需要登录(SESSDATA)
参数( application/x-www-form-urlencoded
**参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ------------------- | ------ | -------------------------- |
@@ -968,13 +992,15 @@ curl -b SESSDATA=xxx -d "fids=205631797&tagids=-10%2C207542&csrf=xxx" http://api
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22104无权限<br />22105未关注 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
示例:
**示例:**
把关注用户`UID=4856007``UID=326499679`同时复制到ID为`231305`的分组中
@@ -998,7 +1024,7 @@ curl -b SESSDATA=xxx -d "fids=4856007%2C326499679&tagids=231305&csrf=xxx" http:/
需要登录(SESSDATA)
参数( application/x-www-form-urlencoded
**参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------------ | ---- | ------------------- | ------ | -------------------------- |
@@ -1009,12 +1035,16 @@ curl -b SESSDATA=xxx -d "fids=4856007%2C326499679&tagids=231305&csrf=xxx" http:/
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-111csrf校验失败<br />-101账号未登录<br />-400请求错误<br />22104无权限<br />22105未关注 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | 作用尚不明确 |
**示例:**
把关注用户`UID=3211734
69``UID=327086920`同时从ID为`207542`的分组移动到ID为`231305`的分组中