From 09c167af4512c40d26002a1d9b173b33da6fd9df Mon Sep 17 00:00:00 2001
From: SocialSisterYi <1440239038@qq.com>
Date: Thu, 18 May 2023 11:58:50 +0800
Subject: [PATCH] =?UTF-8?q?update=E3=80=90=E6=9F=A5=E8=AF=A2=E7=94=A8?=
=?UTF-8?q?=E6=88=B7=E6=8A=95=E7=A8=BF=E3=80=91APIDoc?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/user/space.md | 128 ++++++++++++++++++++++-----------------------
1 file changed, 63 insertions(+), 65 deletions(-)
diff --git a/docs/user/space.md b/docs/user/space.md
index ba6852f..2e53826 100644
--- a/docs/user/space.md
+++ b/docs/user/space.md
@@ -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
最新发布：pubdate
最多播放：click
最多收藏：stow |
-| tid | num | 筛选目标分区 | 非必要 | 默认为0
0：不进行分区筛选
分区tid为所筛选的分区 |
-| keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 |
-| pn | num | 页码 | 非必要 | |
-| ps | num | 每页项数 | 非必要 | 最小1，最大50，默认30 |
+| 参数名 | 类型 | 内容 | 必要性 | 备注 |
+| ------- | ---- | ------------ | ------ | ------------------------------------------------------------ |
+| mid | num | 目标用户mid | 必要 | |
+| order | str | 排序方式 | 非必要 | 默认为pubdate
最新发布：pubdate
最多播放：click
最多收藏：stow |
+| tid | num | 筛选目标分区 | 非必要 | 默认为0
0：不进行分区筛选
分区tid为所筛选的分区 |
+| keyword | str | 关键词筛选 | 非必要 | 用于使用关键词搜索该UP主视频稿件 |
+| pn | num | 页码 | 非必要 | |
+| ps | num | 每页项数 | 非必要 | 最小 1，最大 50，默认 30 |
**json回复：**
根对象：
-| 字段 | 类型 | 内容 | 备注 |
-|---------|-----|------|----------------------------------------------------------------------|
-| code | num | 返回值 | 0：成功
-400：请求错误
-412：请求被拦截
-1200：被降级过滤的请求(一种意义不明的偶发状况) |
-| message | str | 错误信息 | 默认为0 |
-| ttl | num | 1 | |
-| data | obj | 信息本体 | |
+| 字段 | 类型 | 内容 | 备注 |
+| ------- | ---- | -------- | ------------------------------------------------------------ |
+| code | num | 返回值 | 0：成功
-400：请求错误
-412：请求被拦截
-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：否
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：原创
2：转载 |
+| created | num | 投稿时间 | 时间戳 |
+| description | str | 视频简介 | |
+| hide_click | bool | false | 作用尚不明确 |
+| is_pay | num | 0 | 作用尚不明确 |
+| is_union_video | num | 是否为合作视频 | 0：否
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'
```