update【查询用户投稿】APIDoc

This commit is contained in:
SocialSisterYi 2023-05-18 11:58:50 +08:00
parent 410e8d8d35
commit 09c167af45
No known key found for this signature in database
GPG Key ID: 4359DB0F41BEEBBA

View File

@ -2624,38 +2624,37 @@ curl -L -X GET 'https://api.bilibili.com/x/space/like/video?vmid=15858903'
> https://api.bilibili.com/x/space/wbi/arc/search
> https://api.bilibili.com/x/space/arc/search (旧)
PS旧 api 存在一些不同,比如某些情况下,例如 mid=2 时如果没有设置 Cookie 则出现非法访问(-401但新 api 不会。
> ~~https://api.bilibili.com/x/space/arc/search (旧 API现已不可用~~
PS旧 API 现已不可使用,活返回`code=-799`
*请求方式GET*
**header字段**
必须要有 `user-agent`,且不能为 `空字符串`,以及含有 `python`、`node`、`curl` 等的字符串
必须要有 `user-agent`,且不能为 `空字符串`,以及含有 `python`、`node`、`curl` 等的字符串
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|---------|-----|---------|-----|-------------------------------------------------------------|
| mid | num | 目标用户mid | 必要 | |
| order | str | 排序方式 | 非必要 | 默认为pubdate<br />最新发布pubdate<br />最多播放click<br />最多收藏stow |
| tid | num | 筛选目标分区 | 非必要 | 默认为0<br />0不进行分区筛选<br />分区tid为所筛选的分区 |
| keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 |
| pn | num | 页码 | 非必要 | |
| ps | num | 每页项数 | 非必要 | 最小1最大50默认30 |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------- | ---- | ------------ | ------ | ------------------------------------------------------------ |
| mid | num | 目标用户mid | 必要 | |
| order | str | 排序方式 | 非必要 | 默认为pubdate<br />最新发布pubdate<br />最多播放click<br />最多收藏stow |
| tid | num | 筛选目标分区 | 非必要 | 默认为0<br />0不进行分区筛选<br />分区tid为所筛选的分区 |
| keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 |
| pn | num | 页码 | 非必要 | |
| ps | num | 每页项数 | 非必要 | 最小 1最大 50默认 30 |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|----------------------------------------------------------------------|
| code | num | 返回值 | 0成功<br />-400请求错误<br />-412请求被拦截<br />-1200被降级过滤的请求(一种意义不明的偶发状况) |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-400请求错误<br />-412请求被拦截<br />-1200被降级过滤的请求(一种意义不明的偶发状况) |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象:
@ -2677,55 +2676,55 @@ PS旧 api 存在一些不同,比如某些情况下,例如 mid=2 时如果
`list`中的`tlist`对象:
| 字段 | 类型 | 内容 | 备注 |
|-------|-----|--------|--------------|
| {tid} | obj | 该分区的详情 | 字段名为存在的分区tid |
| …… | obj | …… | 向下扩展 |
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | ------------ | ---------------------- |
| {tid} | obj | 该分区的详情 | 字段名为存在的分区 tid |
| …… | obj | …… | 向下扩展 |
`tlist`中的`{tid}`对象:
| 字段 | 类型 | 内容 | 备注 |
|-------|-----|------------|-----|
| count | num | 投稿至该分区的视频数 | |
| name | str | 该分区名称 | |
| tid | num | 该分区tid | |
| 字段 | 类型 | 内容 | 备注 |
| ----- | ---- | -------------------- | ---- |
| count | num | 投稿至该分区的视频数 | |
| name | str | 该分区名称 | |
| tid | num | 该分区 tid | |
`list`中的`vlist`数组:
| 项 | 类型 | 内容 | 备注 |
|-----|-----|-----------|-----|
| 0 | obj | 投稿视频1 | |
| n | obj | 投稿视频n+1 | |
| …… | obj | …… | …… |
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | --------------- | ---- |
| 0 | obj | 投稿视频 1 | |
| n | obj | 投稿视频n+1 | |
| …… | obj | …… | …… |
`list`中的`vlist`数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
|------------------|------|----------|--------------------------------------------------------------------------------|
| aid | num | 稿件avid | |
| author | str | 视频UP主 | 不一定为目标用户(合作视频) |
| bvid | str | 稿件bvid | |
| comment | num | 视频评论数 | |
| copyright | str | 空 | 作用尚不明确 |
| created | num | 投稿时间 | 时间戳 |
| description | str | 视频简介 | |
| hide_click | bool | false | 作用尚不明确 |
| is_pay | num | 0 | 作用尚不明确 |
| is_union_video | num | 是否为合作视频 | 0<br />1 |
| length | str | 视频长度 | MM:SS |
| mid | num | 视频UP主mid | 不一定为目标用户(合作视频) |
| pic | str | 视频封面 | |
| 字段 | 类型 | 内容 | 备注 |
| ---------------- | ---- | -------------- | ------------------------------------------------------------ |
| aid | num | 稿件 avid | |
| author | str | 视频 UP | 不一定为目标用户(合作视频) |
| bvid | str | 稿件 bvid | |
| comment | num | 视频评论数 | |
| copyright | str | 稿件类型 | 1原创<br />2转载 |
| created | num | 投稿时间 | 时间戳 |
| description | str | 视频简介 | |
| hide_click | bool | false | 作用尚不明确 |
| is_pay | num | 0 | 作用尚不明确 |
| is_union_video | num | 是否为合作视频 | 0<br />1是 |
| length | str | 视频长度 | MM:SS |
| mid | num | 视频 UP mid | 不一定为目标用户(合作视频) |
| pic | str | 视频封面 | |
| play | num | 视频播放次数 | 如果视频基本信息API对应的状态为-403视频访问权限不足数据类型将变为str"play": "--",于mid79发表的av5132474可见 |
| review | num | 0 | 作用尚不明确 |
| subtitle | str | 空 | 作用尚不明确 |
| title | str | 视频标题 | |
| typeid | num | 视频分区tid | |
| video_review | num | 视频弹幕数 | |
| is_steins_gate | num | 0 | |
| is_live_playback | num | 0 | |
| meta | | | |
| is_avoided | num | 0 | |
| attribute | num | 0 | |
| review | num | 0 | 作用尚不明确 |
| subtitle | str | 空 | 作用尚不明确 |
| title | str | 视频标题 | |
| typeid | num | 视频分区 tid | |
| video_review | num | 视频弹幕数 | |
| is_steins_gate | num | 0 | |
| is_live_playback | num | 0 | |
| meta | | | |
| is_avoided | num | 0 | |
| attribute | num | 0 | |
`data`中的`page`对象:
@ -2737,10 +2736,10 @@ PS旧 api 存在一些不同,比如某些情况下,例如 mid=2 时如果
`data`中的`episodic_button`对象:
| 字段 | 类型 | 内容 | 备注 |
|------|-----|----------|-----|
| text | str | 按钮文字 | |
| uri | str | 全部播放页url | |
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------- | ---- |
| text | str | 按钮文字 | |
| uri | str | 全部播放页 url | |
**示例:**
@ -2750,10 +2749,9 @@ PS旧 api 存在一些不同,比如某些情况下,例如 mid=2 时如果
```shell
curl -G 'https://api.bilibili.com/x/space/wbi/arc/search' \
--data-urlencode 'mid=53456' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1' \
--user-agent 'go'
--data-urlencode 'mid=53456' \
--data-urlencode 'ps=2' \
--data-urlencode 'pn=1'
```
<details>