返回提交历史
Modified
docs/creativecenter/season.md
+170
-0
Modified
docs/creativecenter/upload.md
+846
-6
XFEstudio/bilibili-API-collect
补充上传稿件和合集相关接口 (#1315)
* feat: 补充上传稿件和合集相关接口 * 补充新分新区的细节
73a2d98
代码差异
2 个文件
+1016
-6
@@ -916,3 +916,173 @@ curl -G --url 'https://member.bilibili.com/x2/creative/web/season/section' \
916
916
917
917
</details>
918
918
919
## 编辑投稿视频合集
920
921
> https://member.bilibili.com/x2/creative/web/season/switch
922
*请求方式: POST*
923
924
认证方式：Cookie(SESSDATA)
925
926
**URL参数:**
927
928
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
929
| ------ | ---- | -------- | ------ | ---- |
930
| t | num | 当前时间 | 非必要 | UNIX 毫秒时间戳 |
931
| csrf | str | CSRF Token (位于 Cookie 中 bili_jct) | 必要 | |
932
933
**正文参数(application/json):**
934
935
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
936
| ------ | ---- | -------- | ------ | ---- |
937
| aid | num | 视频 ID | 必要 | |
938
| season_id | num | null | 合集 ID | 必要 | null 表示从合集中移除 |
939
| section_id | num | null | 小节 ID | 必要 | null 表示从小节中移除 |
940
| title | str | 视频标题 | 必要 | |
941
| csrf | str | CSRF Token (位于 Cookie 中 bili_jct) | 非必要 | |
942
943
**JSON回复:**
944
945
根对象:
946
947
| 字段 | 类型 | 内容 | 备注 |
948
| ------- | ---- | -------- | ----- |
949
| season_id | num | null | | |
950
| section_id | num | null | | |
951
| title | str | 标题 | |
952
| aid | num | aid | |
953
| csrf | num | CSRF Token (位于 Cookie 中 bili_jct) | |
954
955
**示例:**
956
957
```shell
958
curl -X POST "https://member.bilibili.com/x2/creative/web/season/switch" \
959
--url-query "csrf=xxxxxxxxxxxx" \
960
-H "Content-Type: application/json" \
961
--data '{
962
"aid": 123456,
963
"season_id": 654321,
964
"section_id": 789012,
965
"title": "新视频标题"
966
}' \
967
-b "SESSDATA=xxxxxxxxxxx"
968
```
969
970
<details>
971
<summary>查看响应示例:</summary>
972
973
```json
974
{
975
"season_id": null,
976
"section_id": null,
977
"title": "标题",
978
"aid": 123,
979
"csrf": "eqweeqw"
980
}
981
```
982
983
</details>
984
985
## aid反查合集id
986
987
> https://member.bilibili.com/x2/creative/web/season/aid
988
*请求方式: GET*
989
990
认证方式：Cookie(SESSDATA)
991
992
**URL参数:**
993
994
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
995
| ------ | ---- | -------- | ------ | ---- |
996
| id | num | 视频 aid | 必要 | |
997
998
**JSON回复:**
999
1000
根对象:
1001
1002
| 字段 | 类型 | 内容 | 备注 |
1003
| ------- | ---- | -------- | ----- |
1004
| code | num | 返回值 | 0: 成功<br />其他: 失败 |
1005
| message | str | 错误信息 | 默认为 0 |
1006
| ttl | num | 1 | |
1007
| data | obj | 信息本体 | |
1008
1009
1010
1011
`data` 对象:
1012
1013
| 字段 | 类型 | 内容 | 备注 |
1014
| ---- | ---- | -------- | ---- |
1015
| season | obj | 合集信息 | |
1016
1017
1018
`season` 对象:
1019
1020
| 字段 | 类型 | 内容 | 备注 |
1021
| ---- | ---- | -------- | ---- |
1022
| id | num | 合集 ID | |
1023
| title | str | 合集标题 | |
1024
| cover | str | 合集封面 URL | |
1025
| desc | str | 合集描述 | |
1026
| isEnd | num | 是否已完结 | 0: 未完结<br />1: 已完结 |
1027
| mid | num | 合集作者 ID | |
1028
| isAct | num | 是否为活动合集 | 0: 否<br />1: 是 |
1029
| is_pay | num | 是否付费 | 0: 否<br />1: 是 |
1030
| state | num | 合集状态 | 0: 正常显示<br />-6: 正在审核 |
1031
| partState | num | 合集分段状态 | 0: 正常 |
1032
| signState | num | 合集签名状态 | 0: 正常 |
1033
| rejectReason | str | 合集拒绝原因 | |
1034
| ctime | num | 创建时间 | UNIX 时间戳 |
1035
| mtime | num | 修改时间 | UNIX 时间戳 |
1036
| no_section | num | 是否设小节 | 1: 不设小节 |
1037
| forbid | num | 合集是否禁止 | 0: 否<br />1: 是 |
1038
| protocol_id | str | 协议 ID | |
1039
| ep_num | num | 视频数量 | |
1040
| season_price | num | 合集价格 | 0: 免费 |
1041
| is_opened | num | 是否公开 | 1: 公开<br />0: 不公开 |
1042
| has_charging_pay | num | 是否充电付费 | 0: 否<br />1: 是 |
1043
| has_pugv_pay | num | 是否 PUGV 付费 | 0: 否<br />1: 是 |
1044
1045
**示例:**
1046
1047
```shell
1048
curl -G "https://member.bilibili.com/x2/creative/web/season/aid" \
1049
--data-urlencode "id=123456" \
1050
-b "SESSDATA=xxxxxxxxxxx"
1051
```
1052
1053
<details>
1054
<summary>查看响应示例:</summary>
1055
1056
```json
1057
{
1058
"code": 0,
1059
"message": "0",
1060
"ttl": 1,
1061
"data": {
1062
"id": 12,
1063
"title": "合集标题",
1064
"desc": "",
1065
"cover": "",
1066
"isEnd": 0,
1067
"mid": 123,
1068
"isAct": 0,
1069
"is_pay": 0,
1070
"state": 0,
1071
"partState": 0,
1072
"signState": 0,
1073
"rejectReason": "",
1074
"ctime": 1667232000,
1075
"mtime": 1667232000,
1076
"no_section": 1,
1077
"forbid": 0,
1078
"protocol_id": "",
1079
"ep_num": 0,
1080
"season_price": 0,
1081
"is_opened": 1,
1082
"has_charging_pay": 0,
1083
"has_pugv_pay": 0
1084
}
1085
}
1086
```
1087
1088
</details>