Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ad7fe656f7
bilibili-API-collect/docs/creativecenter/upload.md
Session小胡 1e24c6b188
调整部分接口描述与错误修复 (#1088) 
* fix(search/search_request.md): cookie buvid3

* feat(login/login_action/password.md): more sms desc

* fix: typo

* feat(live/info.md): add ps for getRoomBaseInfo

* fix(danmaku/action.md): broken form

* chore: Browserslist: caniuse-lite is outdated

* feat(comment/list.md): reply/wbi/main param next

* feat(misc/buvid3_4.md): get buvid3 only

* fix: broken links & wrong code type

* feat: close all img & br tags

* feat(login/cookie_refresh.md): missing demo links

* feat(dynamic/detail.md): /lottery_svr/v1/lottery_svr/lottery_notice

* fix(video/action.md): share cookie buvid3

* feat: deprecated stat & attribute

* feat(dynamic/detail.md): reaction

* feat(misc/sign/v_voucher.md): header

* feat(dynamic/detail.md): update detail params & example

* feat(APP_widget/ver.md): /x/v2/version

* feat(video/info.md): update view

* feat(docs/user.md): remove channel

* feat(search/search_request.md): search/type -1200

* feat(user/space.md): audio

* feat(video/player.md): /x/player/wbi/v2

* feat(audio/musicstream_url.md): update web/url

* feat(comment/readme.md): state

* fix(user/medal.md): wrong guard_level desc

* feat(live/message_stream.md): DANMU_MSG

* fix(user/medals): wrong guard_level & guard_icon desc

* feat(live/message_stream.md): format & add more 'cmd'

* feat(live/message_stream.md): add more 'cmd'

* feat(live/message_stream.md): add tips for non-login users

* feat(video/player.md): need_login_subtitle

---------

Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
2024-09-19 23:17:33 +08:00

1088 lines
38 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 投稿
## 上传封面
> https://member.bilibili.com/x/vu/web/cover/up
*请求方式: POST*
认证方式：Cookie(SESSDATA)
注: 目前看来上传的图片似乎不会自动删除
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| ts | num | 当前时间 | 不必要 | UNIX 毫秒时间戳 |
**正文参数(application/x-www-form-urlencoded):**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| csrf | str | CSRF Token (位于 Cookie 中 bili_jct) | 必要 | |
| cover | base64 | 视频封面 | 必要 | 经过 base64 编码的图片数据 |
**JSON回复:**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----- |
| code | num | 返回值 | 0: 成功<br />-400: 请求错误<br />-111: csrf 校验失败<br />-101: 账号未登录 |
| message | str | 错误信息 | 默认为 0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data` 对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| url | str | 封面 URL | |
**示例:**
假设已经把需要发送的数据进行编码存放在文件 `./b64` 中:
```text
csrf=xxxxxxxxxxxx&cover=data%3Aimage%2Fjpeg%3Bbase64%2C%2F9j%2F4AAQSkZJRgABA...
```
发送请求:
```shell
curl -X POST --url "https://member.bilibili.com/x/vu/web/cover/up" \
--url-query "ts=$(date +%s%3N)" \
--data-binary @b64 \
-b "SESSDATA=xxxxxx; bili_jct=xxxxxx"
```
JavaScript (Node.js) 请求[示例](https://gist.github.com/SessionHu/5e47a3a1a351ac5486c87e3d63930e7a)
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"url": "https://archive.biliimg.com/bfs/archive/77906db03b1eefac02613de184afad03f7bc58d7.jpg"
}
}
```
</details>
## 预测稿件类型
> https://member.bilibili.com/x/vupre/web/archive/types/predict
*请求方式: POST*
认证方式: Cookie(SESSDATA)
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| ts | num | 当前时间 | 不必要 | UNIX 毫秒时间戳 |
| csrf | str | CSRF Token (位于 Cookie 中 bili_jct) | 必要 | |
**正文参数(multipart/form-data):**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| filename | str | 视频文件名 | 必要 | 从视频上传接口获取, 无后缀名, 可为空 |
| title | str | 视频标题 | 不必要 ||
| upload_id | str | 上传 ID | 不必要 | 如 `616368979_1723455540876_8794` |
**JSON回复:**
根对象:
|字段|类型|内容|备注|
|---|-|-|---|
|code|num|返回值|0: 成功<br />-400: 请求错误<br />-111: csrf 校验失败<br />-101: 账号未登录|
|message|str|错误信息|默认为 0|
|ttl|num|1||
|data|array|信息本体||
`data` 数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| 0 | obj | 视频类型 1 | |
| 1 | obj | 视频类型 2 | |
| …… | obj | …… | |
| n | obj | 视频类型 (n+1) | |
`data` 数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| id | num | 子分区 ID | |
| parent | num | 总分区 ID | |
| parent_name | str | 总分区名称 | |
| name | str | 子分区名称 | |
| description | str | 子分区描述 | |
| desc | str | 子分区描述 | 同 `description` |
| intro_original | str | 原创简介说明 | |
| intro_copy | str | 转载简介说明 | |
| notice | str | 注意事项 | |
| copy_right | num | 版权信息? | 0 |
| show | bool | 是否显示? | true |
| rank | num | 排序权重? | |
| max_video_count | num | 最大视频数量? | |
| request_id | str | 空 | |
**示例:**
```shell
curl -X POST --url 'https://member.bilibili.com/x/vupre/web/archive/types/predict' \
--url-query 'csrf=d51eadf05ba3bc6c5f76def7fbcc0185' \
--data-urlencode 'filename=' \
-b 'SESSDATA=xxx; bili_jct=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": [
{
"id": 122,
"parent": 36,
"parent_name": "知识",
"name": "野生技能协会",
"description": "技能展示或技能教学分享类视频",
"desc": "技能展示或技能教学分享类视频",
"intro_original": "可对视频内容进行补充说明，并对所使用的视频素材进行标明。\n如是系列，也可附带上期视频地址。\n请勿加入涉政或具较大争议性的文字简介，否则将做打回处理。",
"intro_copy": "转载稿件需标明出处，请注明原作者、原作者频道名或原作者投稿地址。\n可对相关内容进行补充说明。\n请勿加入涉政或具较大争议性的文字简介，否则将做打回处理。\n如是系列，也可附带上期视频地址。",
"notice": "清晰明了表明内容亮点的标题会更受观众欢迎哟！",
"copy_right": 0,
"show": true,
"rank": 75,
"max_video_count": 100,
"request_id": ""
},
{
"id": 21,
"parent": 160,
"parent_name": "生活",
"name": "日常",
"description": "一般日常向的生活类视频",
"desc": "一般日常向的生活类视频",
"intro_original": "能够选择自制的必须是up主个人或工作室自己制作剪辑的视频，除此之外的搬运视频字幕制作，对于视频进行加速、慢放等简易二次创作，在视频中添加前后贴片或者打水印等行为均不被认作自制",
"intro_copy": "转载需写明请注明转载作品详细信息原作者、原标题及出处（需为该视频最原始出处，如所标注明显为非原始出处的话会被打回）",
"notice": "",
"copy_right": 0,
"show": true,
"rank": 4,
"max_video_count": 50,
"request_id": ""
},
{
"id": 242,
"parent": 5,
"parent_name": "娱乐",
"name": "娱乐粉丝创作",
"description": "粉丝向创作视频",
"desc": "粉丝向创作视频",
"intro_original": "",
"intro_copy": "",
"notice": "清晰明了表明内容亮点的标题会更受观众欢迎哟！",
"copy_right": 0,
"show": true,
"rank": 40,
"max_video_count": 50,
"request_id": ""
},
{
"id": 65,
"parent": 4,
"parent_name": "游戏",
"name": "网络游戏",
"description": "多人在线游戏为主要内容的相关视频",
"desc": "多人在线游戏为主要内容的相关视频",
"intro_original": "建议在简介和TAG中添加正确的游戏名，以便在分区和搜索中得到更好的展示。\n录制他人直播（包括授权转载、授权录制）不属于自制内容，请选转载。",
"intro_copy": "建议在简介和TAG中添加正确的游戏名。\n搬运转载内容请添加原作者、原链接地址信息。录制他人直播内容请添加原主播信息、直播时间。\n未添加正确转载、录播信息的稿件可能被打回。",
"notice": "【UP主/节目名】+《游戏名》+主要标题+期号",
"copy_right": 0,
"show": true,
"rank": 30,
"max_video_count": 50,
"request_id": ""
},
{
"id": 138,
"parent": 160,
"parent_name": "生活",
"name": "搞笑",
"description": "搞笑挑战、剪辑、表演、配音以及各类日常沙雕视频",
"desc": "搞笑挑战、剪辑、表演、配音以及各类日常沙雕视频",
"intro_original": "能够选择自制的必须是up主个人或工作室自己制作剪辑的视频，除此之外的搬运视频字幕制作，对于视频进行加速、慢放等简易二次创作，在视频中添加前后贴片或者打水印等行为均不被认作自制",
"intro_copy": "转载需写明请注明转载作品详细信息原作者、原标题及出处（需为该视频最原始出处，如所标注明显为非原始出处的话会被打回）",
"notice": "",
"copy_right": 0,
"show": true,
"rank": 30,
"max_video_count": 50,
"request_id": ""
}
]
}
```
</details>
## 预测稿件标签
> https://member.bilibili.com/x/vupre/web/tag/recommend
*请求方式: GET*
认证方式: Cookie(SESSDATA)
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| upload_id | str | 同 [预测稿件类型](#预测稿件类型) 的 `upload_id` | 不必要 | |
| subtype_id | int | 子分区 ID | 不必要 | |
| title | str | 视频标题 | 不必要 | |
| filename | str | 同 [预测稿件类型](#预测稿件类型) 的 `filename` | 不必要 | |
| description | str | 视频简介 | 不必要 | |
| cover_url | str | 视频封面 URL | 不必要 | 不含 `https:` 或 `http:` 字串 |
| t | int | 当前 UNIX 毫秒时间戳 | 不必要 | |
**JSON回复:**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | ---- | ---- |
| code | int | 返回值 | 0: 成功<br />-101: 账号未登录 |
| data | array | 标签信息 | |
| message | str | 错误信息 | 默认为 0 |
| request_id | str | 请求 ID | |
`data` 数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| 0 | obj | 标签 1 | |
| 1 | obj | 标签 2 | |
| …… | obj | …… | |
| n | obj | 标签 (n+1) | |
`data` 数组中的对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ---- |
| tag | str | 标签名称 | |
| checked | int | 0 | |
| request_id | str | 请求 ID | 同根对象 |
**示例:**
```shell
curl -G 'https://member.bilibili.com/x/vupre/web/tag/recommend' \
--url-query 'subtype_id=122' \
--url-query 'title=Telnet手打HTTP' \
--url-query 'description=测试用 Telnet 手打 HTTP/1.x 协议访问本地服务器, 无 SSL/TLS 支持'
-b 'SESSDATA=xxx'
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"data": [
{
"tag": "学习",
"checked": 0,
"request_id": "TAG_1723543336295_3371"
},
{
"tag": "编程",
"checked": 0,
"request_id": ""
},
{
"tag": "课程",
"checked": 0,
"request_id": ""
},
{
"tag": "学习心得",
"checked": 0,
"request_id": ""
},
{
"tag": "经验分享",
"checked": 0,
"request_id": ""
}
],
"message": "0",
"request_id": "TAG_1723543336295_3371"
}
```
</details>
## 投递视频稿件
> https://member.bilibili.com/x/vu/web/add/v3
*请求方式: POST*
认证方式：Cookie(SESSDATA)
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| ts | num | 当前时间 | 不必要 | UNIX 毫秒时间戳 |
| csrf | str | CSRF Token (位于 Cookie 中 bili_jct) | 必要 | |
**正文参数(application/json):**
根对象:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| videos | array | 视频信息 | 必要 | 若为分 P 视频, 请注意数组元素顺序 |
| cover | str | 视频封面 URL | 必要 | 参见[上传视频封面](#上传视频封面) |
| cover43 | str | 视频封面 URL (比例为 4:3) | 必要 | 可为空 |
| title | str | 视频标题 | 必要 | 最多 80 字 |
| copyright | num | 1: 自制<br />2: 转载 | 必要 | |
| tid | num | 分类 ID | 必要 | |
| tag | str | 视频标签 | 必要 | 多个标签用 `,` 分隔, 最多 10 个 |
| desc_format_id | num | 简介格式 ID? | 必要 | 9999: 纯文本 |
| desc | str | 视频简介 | 必要 | 最多 2000 字 |
| recreate | num | 是否允许二创 | 必要 | -1: 允许(默认)<br />1: 不允许 |
| dynamic | str | 粉丝动态 | 必要 | |
| interactive | num | 互动视频? | 必要 | 0: 否 |
| act_reserve_create | num | 活动预约? | 必要 | 0: 否 |
| no_disturbance | num | 勿扰模式? | 必要 | 0: 否 |
| no_reprint | num | 是否允许转载 | 必要 | 1: 允许<br />0: 不允许 |
| subtitle | obj | 字幕信息 | 必要 | |
| dolby | num | 杜比音效 | 必要 | 0: 否(默认)<br />1: 是 |
| lossless_music | num | 无损音乐 | 必要 | 0: 否(默认)<br />1: 是 |
| up_selection_reply | bool | 精选评论 | 必要 | |
| up_close_reply | bool | 关闭评论 | 必要 | |
| up_close_danmu | bool | 关闭弹幕 | 必要 | |
| web_os | num | 平台类型? | 必要 | 3 |
`videos` 数组中的对象:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| filename | str | 视频文件名 | 必要 | 从视频上传接口获取, 无后缀名 |
| title | str | 分 P 标题 | 必要 | |
| desc | str | 分 P 简介 | 必要 | |
| cid | num | 分 P cid | 必要 | 从视频上传接口获取, 即 `biz_id` |
`subtitle` 对象:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| open | num | 是否启用字幕投稿 | 必要 | 0: 启用(默认)<br />1: 不启用 |
| lan | str | 字幕投稿语言 | 必要 | 可为空 |
**示例:**
假设已经把需要发送的数据存放在文件 `./data.json` 中:
```json
{
"videos": [
{
"filename": "n240728ad33h52yqhxbtw51cb06sq9gx",
"title": "Telnet手打HTTP",
"desc": "",
"cid": 500001629877726
}
],
"cover": "https://archive.biliimg.com/bfs/archive/85447ea20431ef799382c403c84b4bfb82a41053.jpg",
"cover43": "",
"title": "Telnet手打HTTP",
"copyright": 1,
"tid": 122,
"tag": "telnet,socket,tcp,linux,http",
"desc_format_id": 9999,
"desc": "测试用 Telnet 手打 HTTP/1.x 协议访问本地服务器, 无 SSL/TLS 支持",
"recreate": -1,
"dynamic": "for testing",
"interactive": 0,
"act_reserve_create": 0,
"no_disturbance": 0,
"no_reprint": 1,
"subtitle": {
"open": 0,
"lan": ""
},
"dolby": 0,
"lossless_music": 0,
"up_selection_reply": false,
"up_close_reply": false,
"up_close_danmu": false,
"web_os": 3,
"csrf": "xxxxxxxxxxxxxxxxxxxxxxxx"
}
```
发送请求:
```shell
curl -X POST --url "https://member.bilibili.com/x/vu/web/add/v3" \
--url-query "ts=$(date +%s%3N)" \
--url-query "csrf=xxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json; charset=utf-8" \
--data @data.json \
-b "SESSDATA=xxxxxx; bili_jct=xxxxxxxxxxxxxxxxxxxxxxxx"
```
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"aid": 112861976201494,
"bvid": "BV181vnexEmB"
}
}
```
</details>
## 上传视频文件
注: 目前看来上传的视频文件似乎不会自动删除, 而且似乎不是视频也可以上传的样子, 但是下载认证字段有效期只有 5 天
### 上传流程
整个上传流程较为复杂, 详细参见[Demo](#Demo)
1. `GET` `preupload` 接口, [获取上传元数据](#获取上传元数据-预上传)
2. `POST` 第 1 步得到的地址, [上传视频元数据](#上传视频元数据)
3. `PUT` 第 1 步得到的地址, [分片上传视频文件](#分片上传视频文件)
4. `POST` 第 1 步得到的地址, [结束上传视频文件](#结束上传视频文件)
5. `GET` 第 1 步得到的地址, [下载已上传的视频文件](#下载已上传的视频文件) , 确认上传成功 (可选)
### 上传接口
#### 获取上传元数据 (预上传)
> https://member.bilibili.com/preupload
*请求方式: GET*
认证方式：Cookie(SESSDATA)
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| name | str | 文件名 | 必要 | 会影响返回的上传地址 |
| r | str | 上传区域? | 必要 | upos |
| profile | str | 上传配置? | 必要 | 普通视频: ugcfx/bup<br />提交反馈: feedback/bup |
| probe_version | num | 上传版本? | 不必要 | 20221109 |
| upcdn | str | 上传 CDN? | 不必要 | txa |
| zone | str | 上传区域? | 不必要 | cs |
| ssl | num | 是否使用 SSL? | 不必要 | 0 |
| version | str | 上传版本? | 不必要 | 2.14.0.0 |
| build | str | 上传版本? | 不必要 | 2140000 |
| size | num | 文件大小 | 不必要 | 视频文件大小, 单位 字节 |
| webVersion | str | 上传版本? | 不必要 | 2.13.0 |
**JSON回复:**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----- |
| OK | num | 1 | |
| auth | str | 上传凭证 | 作为后面请求中请求头, 有效期 5 天 |
| biz_id | num | 业务 ID? | |
| chunk_retry | num | 重试次数? | |
| chunk_retry_delay | num | 重试延迟? | |
| chunk_size | num | 分块大小 | 后面要用 |
| endpoint | str | 上传节点 | 后面要用 |
| endpoints | array | 上传节点列表 | |
| expose_params | null | | |
| put_query | str | 上传参数? | |
| threads | num | 上传线程数 | |
| timeout | num | 超时时间? | |
| uip | str | 你的 IP | |
| upos_uri | str | 上传地址 | 后面要用 |
`endpoints` 数组:
| 项 | 类型 | 内容 | 备注 |
| ---- | ---- | -------- | ----- |
| 0 | str | 上传节点1 | |
| …… | str | …… | |
| n | str | 上传节点n | |
**示例:**
假设视频文件名为 `2024-07-28_15-37-50.mkv`, 视频大小为 `305333744` 字节
```shell
curl -G "https://member.bilibili.com/preupload" \
--data-urlencode "name=2024-07-28_15-37-50.mkv" \
--data-urlencode "r=upos" \
--data-urlencode "profile=ugcfx/bup" \
-b "SESSDATA=xxxxxxxxxxx"
```
<details>
<summary>查看响应示例:</summary>
```json
{
"OK": 1,
"auth": "ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=b6c5cc520a281200906aea97e190b098&timestamp=1722155211.324&uid=616368979&uip=108.181.24.77&uport=52096&use_dqp=0",
"biz_id": 500001630152509,
"chunk_retry": 10,
"chunk_retry_delay": 3,
"chunk_size": 10485760,
"endpoint": "//upos-cs-upcdntxa.bilivideo.com",
"endpoints": [
"//upos-cs-upcdntxa.bilivideo.com",
"//upos-cs-upcdnalia.bilivideo.com"
],
"expose_params": null,
"put_query": "os=upos&profile=ugcfx%2Fbup",
"threads": 3,
"timeout": 1200,
"uip": "108.181.24.77",
"upos_uri": "upos://ugcfx2lf/n240728ad1p51if4g3ke4s3o95sznogy.mkv"
}
```
</details>
#### 上传视频元数据
> URL 拼接格式: `"https"` + [上一个接口](#获取上传元数据-预上传)的`endpoint` + 上一个接口的`upos_uri`去掉协议名
> JavaScript 模板字符串: `https:${preupload.endpoint}/${endpoint.upos_uri.replace("upos://", "")}`
*请求方式: POST*
认证方式：请求头 `X-Upos-Auth` 为上一接口得到的 `auth`
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| uploads | str | 留空 | 必要 | 留空 |
| output | str | 输出格式 | 不必要 | 默认为 json(推荐), 留空为 xml |
| profile | str | 上传配置? | 必要 | 与上一个接口保持相同 |
| filesize | num | 文件大小 | 必要 | 视频文件大小, 单位 字节<br />feedback/bup 不必要 |
| partsize | num | 分块大小 | 必要 | 上一个接口返回, 且后面要用<br />feedback/bup 不必要 |
| biz_id | num | 业务 ID? | 必要 | 上一个接口返回, 且后面要用<br />feedback/bup 不必要 |
**JSON回复:**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ----- |
| OK | num | 1 | |
| bucket | str | 空间名? | |
| key | str | 文件名? | |
| upload_id | str | 上传 ID | 后面要用 |
**示例:**
假设上一接口返回的
`auth` 为 `ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=4004b35628e982bc90b59cec86f8c441&timestamp=1722173443.298&uid=616368979&uip=104.28.153.18&uport=44282&use_dqp=0`,
`biz_id` 为`500001630454700`,
`endpoint` 为 `//upos-cs-upcdntxa.bilivideo.com`,
`upos_uri` 为 `upos://ugcfx2lf/n240728adhejliqv0kqyg2s5n6huv501.mkv`,
`chunk_size` 为 `10485760`.
视频文件大小为 `305333744` 字节.
```shell
curl -X POST --url "https://upos-cs-upcdntxa.bilivideo.com/ugcfx2lf/n240728adhejliqv0kqyg2s5n6huv501.mkv` \
--url-query "uploads=" \
--url-query "output=json" \
--url-query "profile=ugcfx/bup" \
--url-query "filesize=305333744" \
--url-query "partsize=10485760" \
--url-query "biz_id=500001630454700" \
-H "X-Upos-Auth: ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=4004b35628e982bc90b59cec86f8c441&timestamp=1722173443.298&uid=616368979&uip=104.28.153.18&uport=44282&use_dqp=0" \
-b "SESSDATA=xxxxxxxxx"
```
<details>
<summary>查看响应示例:</summary>
```json
{
"OK": 1,
"bucket": "ugcfx2lf",
"key": "/n240728adhejliqv0kqyg2s5n6huv501.mkv",
"upload_id": "26c674b4-0dce-45f5-a9cd-a199d9c982bf"
}
```
</details>
#### 分片上传视频文件
> URL 同 [上一个接口](#上传视频元数据)
*请求方式: PUT*
认证方式：请求头 `X-Upos-Auth` 为上上一接口得到的 `auth`
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| partNumber | num | 分块序号 | 必要 | 从 1 开始 |
| uploadId | str | 上传 ID | 必要 | 上一个接口返回 |
| chunk | num | 分块序号 | 必要 | 从 0 开始 |
| chunks | num | 分块总数 | 必要 | 自行计算: 文件大小除以分块大小并向上取整 |
| size | num | 该分块大小 | 必要 | 该实际上传字节数 |
| start | num | 该分块开始位置 | 必要 | 已实际上传字节数 |
| end | num | 该分块结束位置 | 必要 | 该分块上传结束后实际上传总字节数 |
| total | num | 总大小 | 必要 | 视频文件大小, 单位 字节 |
**正文参数(application/octet-stream):**
视频文件在该分块的字节流
**纯文本回复:**
```text
MULTIPART_PUT_SUCCESS
```
**示例:**
假设上上一接口返回的
`auth` 为 `ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0`,
`endpoint` 为 `//upos-cs-upcdntxa.bilivideo.com`,
`upos_uri` 为 `upos://ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz`,
`chunk_size` 为 `10485760`.
上一接口返回的
`upload_id` 为 `8130090a-16f7-4fe6-8a29-198f5abce913`.
视频文件名为 `20240724-remove-linux-then-install.tar.xz`, 文件大小为 `278255704` 字节.
假设您要上传的分块序号为 `1`,
该分块大小为 `10485760`,
该分块开始位置为 `0`,
该分块结束位置为 `10485760`,
该分块实际上传字节数为 `10485760`,
您已将文件分块存放至 `part01.tar.xz`, `part02.tar.xz`, ..., `part27.tar.xz`.
```shell
curl -X PUT --url "https://upos-cs-upcdntxa.bilivideo.com/ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz" \
--url-query "partNumber=1" \
--url-query "uploadId=8130090a-16f7-4fe6-8a29-198f5abce913" \
--url-query "chunk=0" \
--url-query "chunks=27" \
--url-query "size=10485760" \
--url-query "start=0" \
--url-query "end=10485760" \
--url-query "total=278255704" \
-H "X-Upos-Auth: ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0" \
-H "Content-Type: application/octet-stream" \
--data-binary @part01.tar.xz \
-b "SESSDATA=xxxxxxxxx"
```
<details>
<summary>查看响应示例:</summary>
```text
MULTIPART_PUT_SUCCESS
```
</details>
#### 结束上传视频文件
> URL 同 [上一个接口](#分片上传视频文件)
*请求方式: POST*
认证方式：请求头 `X-Upos-Auth` 为上上上一接口得到的 `auth`
**URL参数:**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | -------- | ------ | ---- |
| output | str | 输出格式 | 不必要 | 默认为 json(推荐), 留空为 xml |
| name | str | 文件名 | 必要 | 视频文件名 |
| profile | str | 上传配置? | 必要 | 与上一个接口相同, 普通视频: ugcfx/bup |
| uploadId | str | 上传 ID | 必要 | 与上一个接口相同 |
| biz_id | num | 业务 ID? | 必要 | 与上上一个接口相同 |
**正文参数(application/json):**
根对象:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---- | ------ | ---- |
| parts | array | 各分块信息 | 必要 | 按实际上传顺序而不是分块序号顺序 |
`parts` 数组:
| 项 | 类型 | 内容 | 必要性 | 备注 |
| --- | ---- | ---- | ------ | ---- |
| 0 | obj | 分块信息1 | 必要 | 按实际上传顺序而不是分块序号顺序 |
| 1 | obj | 分块信息2 | 必要 | |
| …… | obj | …… | | |
| n | obj | 分块信息n | 必要 | |
`parts` 数组中的对象:
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ------ | ---- | ---- | ------ | ---- |
| partNumber | num | 分块序号 | 必要 | 从 1 开始 |
| eTag | str | `etag` | 必要 | |
**JSON回复:**
与 [上上一个接口](#上传视频元数据) 相同
**示例:**
假设上上上一接口返回的
`auth` 为 `ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0`,
`endpoint` 为 `//upos-cs-upcdntxa.bilivideo.com`,
`upos_uri` 为 `upos://ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz`,
`biz_id` 为 `500001630826789`.
上上一接口返回的
`upload_id` 为 `8130090a-16f7-4fe6-8a29-198f5abce913`.
视频文件名为 `20240724-remove-linux-then-install.tar.xz`, 文件大小为 `278255704` 字节.
假设您已经全部上传完毕, 共上传 `27` 个分块, 本次请求上传的的内容存放在 `body.json` 文件中.
```shell
curl -X PUT --url "https://upos-cs-upcdntxa.bilivideo.com/ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz" \
--url-query "output=json" \
--url-query "name=20240724-remove-linux-then-install.tar.xz" \
--url-query "profile=ugcfx%2Fbup" \
--url-query "uploadId=8130090a-16f7-4fe6-8a29-198f5abce913" \
--url-query "biz_id=500001630826789" \
-H "X-Upos-Auth: ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0" \
-H "Content-Type: application/json" \
--data-binary @body.json \
-b "SESSDATA=xxxxxxxxx"
```
<details>
<summary>查看响应示例:</summary>
```json
{
"OK": 1,
"location": "ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz",
"bucket": "ugcfx2lf",
"key": "/n240729ad7gxi43yaoml312h2nbt2pnf.xz"
}
```
</details>
#### 下载已上传的视频文件
> URL 同 [上一个接口](#结束上传视频文件)
*请求方式: GET*
认证方式：请求头 `X-Upos-Auth` 为上上上上一接口得到的 `auth`
注: 由于 `X-Upos-Auth` 有效期只有 5 天, 过期请求将返回 HTTP 403 如下
```http
HTTP/1.1 403 Forbidden
Bili-Trace-Id: 3e3f2db61366adbf
Server: upos@hcsgw@jscs-bvc-hcsgw-public-02
X-Bili-Trace-Id: 0d8ca1af6d3510253e3f2db61366adbf
X-Upos-Auth: AUTH_TS_GT_5DAY AUTH=ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0 Now=1722662669 DURATION=449893
Content-Length: 0
Connection: keep-alive
Date: Sat, 03 Aug 2024 05:24:29 GMT
EO-LOG-UUID: 4296647794590631154
EO-Cache-Status: MISS
```
**字节流回复:**
视频文件字节流
**示例:**
假设请求上一接口时的 URL 为 `https://upos-cs-upcdntxa.bilivideo.com/ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz`,
请求头的 `X-Upos-Auth` 为 `ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0`,
您想要下载到运行目录下的 `file.tar.xz` 文件
```shell
curl -G "https://upos-cs-upcdntxa.bilivideo.com/ugcfx2lf/n240729ad7gxi43yaoml312h2nbt2pnf.xz" \
-H "X-Upos-Auth: ak=1494471752&cdn=%2F%2Fupos-cs-upcdntxa.bilivideo.com&os=upos&sign=911dd5b995895805d785aa607b4153b6&timestamp=1722212776.333&uid=616368979&uip=108.181.24.77&uport=36044&use_dqp=0" \
--output file.tar.xz
```
<details>
<summary>查看检查示例:</summary>
```text
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 265M 100 265M 0 0 9493k 0 0:00:28 0:00:28 --:--:-- 10.3M
$ sha512sum file.tar.xz
abfbedf1ac4f251c81103beb4d5406af1e0b64b9d54e99bfc77d2a8a9c4913a9fd2f1751828ace8aac036f6385609d99e251437b07a0491caca2ad7069a57003 file.tar.xz
$ sha512sum ~/Documents/video-proj/20240724-remove-linux-then-install.tar.xz
abfbedf1ac4f251c81103beb4d5406af1e0b64b9d54e99bfc77d2a8a9c4913a9fd2f1751828ace8aac036f6385609d99e251437b07a0491caca2ad7069a57003 /home/sess/Documents/video-proj/20240724-remove-linux-then-install.tar.xz
```
</details>
### Demo
#### Java
注: 需要 Gson 依赖, Java 8+, 单线程上传, 无异常处理, 仅供参考
```java
import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URI;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.StringJoiner;
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.JsonArray;
import com.google.gson.JsonObject;
import com.google.gson.JsonSyntaxException;
/**
* A demo class for uploading videos to Bilibili.
*
* @author SessX6cf
*/
public class BiliVideoUploader {
private static String SESSDATA;
private static File VIDEO_FILE;
public static void main(String[] args) throws IOException {
long ts = System.currentTimeMillis();
if (args.length < 2) {
System.out.println("Usage: java BiliVideoUploader <video_file> <sessdata>");
return;
} else {
VIDEO_FILE = new File(args[0]);
if (!VIDEO_FILE.isFile()) {
System.out.println("It is not a file!");
return;
} else if (!VIDEO_FILE.canRead()) {
System.out.println("Cannot read the file!");
return;
} else if (VIDEO_FILE.isDirectory()) {
System.out.println("You can play a directory?!");
return;
}
SESSDATA = args[1];
}
// step 1: preupload video
System.out.println("step 1: preupload video");
JsonObject preuploadVideo = preuploadVideo();
// step 2: post video meta
System.out.println("step 2: post video meta");
JsonObject postVideoMeta = postVideoMeta(preuploadVideo);
// step 3: upload video
System.out.println("step 3: upload video");
int chunks = uploadVideo(preuploadVideo, postVideoMeta);
// step 4: end upload
System.out.println("step 4: end upload");
endupload(preuploadVideo, postVideoMeta, chunks);
// finished
System.out.println("finished (" + (System.currentTimeMillis() - ts) + "ms)");
}
private static String querypart(String key, String value) throws IOException {
return key + "=" + URLEncoder.encode(value, "UTF-8");
}
private static HttpURLConnection conn(String url, String method) throws IOException {
HttpURLConnection conn;
try {
conn = (HttpURLConnection) new URI(url).toURL().openConnection();
} catch (java.net.URISyntaxException e) {
throw new IOException(e);
}
conn.setRequestMethod(method);
// conn.setRequestProperty("User-Agent", "Mozilla/5.0 (X11; Linux x86_64; rv:109.0) Gecko/20100101 Firefox/115.0");
if (url.contains("bilibili.com")) conn.setRequestProperty("Cookie", "SESSDATA=" + SESSDATA);
return conn;
}
private static byte[] inputStreamToString(HttpURLConnection conn) throws IOException {
ByteArrayOutputStream baos = new ByteArrayOutputStream();
InputStream in;
in = conn.getInputStream();
int b;
while ((b = in.read()) != -1) {
baos.write(b);
}
in.close();
return baos.toByteArray();
}
private static final Gson GSON = new GsonBuilder().setPrettyPrinting().create();
private static JsonObject preuploadVideo() throws IOException {
StringJoiner url = new StringJoiner("&", "https://member.bilibili.com/preupload?", "");
url.add(querypart("name", VIDEO_FILE.getName()));
// url.add(querypart("size", String.valueOf(VIDEO_FILE.length())));
url.add(querypart("r", "upos"));
url.add(querypart("profile", "ugcfx/bup"));
HttpURLConnection conn = conn(url.toString(), "GET");
System.out.println("GET " + url.toString());
String response = new String(inputStreamToString(conn), StandardCharsets.UTF_8);
try {
JsonObject json = GSON.fromJson(response, JsonObject.class);
System.out.println(GSON.toJson(json));
return json;
} catch (JsonSyntaxException e) {
System.out.println(response);
throw e;
}
}
private static JsonObject postVideoMeta(JsonObject preuploadVideo) throws IOException {
String schemeandhost = "https:" + preuploadVideo.get("endpoint").getAsString();
String path = preuploadVideo.get("upos_uri").getAsString().replaceFirst("upos:/", "");
StringJoiner url = new StringJoiner("&", schemeandhost + path + "?", "");
url.add(querypart("uploads", "")); // WARNING: this is not a typo, it's required, or 404
url.add(querypart("output", "json"));
url.add(querypart("profile", "ugcfx/bup"));
url.add(querypart("filesize", String.valueOf(VIDEO_FILE.length())));
url.add(querypart("partsize", preuploadVideo.get("chunk_size").getAsString()));
url.add(querypart("biz_id", preuploadVideo.get("biz_id").getAsString()));
HttpURLConnection conn = conn(url.toString(), "POST");
conn.setRequestProperty("X-Upos-Auth", preuploadVideo.get("auth").getAsString()); // 403 without it
System.out.println("POST " + url.toString());
String response = new String(inputStreamToString(conn), StandardCharsets.UTF_8);
try {
JsonObject json = GSON.fromJson(response, JsonObject.class);
System.out.println(GSON.toJson(json));
return json;
} catch (JsonSyntaxException e) {
System.out.println(response);
throw e;
}
}
private static int uploadVideo(JsonObject preuploadVideo, JsonObject postVideoMeta) throws IOException {
long startts = System.currentTimeMillis() - 1;
String schemeandhost = "https:" + preuploadVideo.get("endpoint").getAsString();
String path = preuploadVideo.get("upos_uri").getAsString().replaceFirst("upos:/", "");
String urlp = schemeandhost + path + "?";
long length = VIDEO_FILE.length();
byte[] buffer = new byte[preuploadVideo.get("chunk_size").getAsInt()];
int size = 0;
int chunks = (int) Math.ceil(length / (double) buffer.length);
InputStream in = new FileInputStream(VIDEO_FILE);
for (int chunk = 0; chunk < chunks; chunk++) {
System.out.println("speed: " + (chunk * buffer.length) / (System.currentTimeMillis() - startts) + "bytes/s");
System.out.println("chunk: " + (chunk + 1) + "/" + chunks);
size = in.read(buffer, 0, buffer.length);
if (size == -1) {
break;
}
StringJoiner url = new StringJoiner("&", urlp, "");
url.add(querypart("partNumber", String.valueOf(chunk + 1)));
url.add(querypart("uploadId", postVideoMeta.get("upload_id").getAsString()));
url.add(querypart("chunk", String.valueOf(chunk)));
url.add(querypart("chunks", String.valueOf(chunks)));
url.add(querypart("size", String.valueOf(size)));
url.add(querypart("start", String.valueOf(chunk * buffer.length)));
url.add(querypart("end", String.valueOf((chunk) * buffer.length + size)));
url.add(querypart("total", String.valueOf(length)));
HttpURLConnection conn = conn(url.toString(), "PUT");
conn.setRequestProperty("X-Upos-Auth", preuploadVideo.get("auth").getAsString());
conn.setRequestProperty("Content-Type", "application/octet-stream");
conn.setRequestProperty("Content-Length", String.valueOf(size));
conn.setDoOutput(true);
conn.getOutputStream().write(buffer, 0, size);
System.out.println("PUT " + url.toString());
String response = new String(inputStreamToString(conn), StandardCharsets.UTF_8);
System.out.println(response);
}
in.close();
return chunks;
}
private static void endupload(JsonObject preuploadVideo, JsonObject postVideoMeta, int chunks) throws IOException {
String schemeandhost = "https:" + preuploadVideo.get("endpoint").getAsString();
String path = preuploadVideo.get("upos_uri").getAsString().replaceFirst("upos:/", "");
StringJoiner url = new StringJoiner("&", schemeandhost + path + "?", "");
url.add(querypart("output", "json"));
url.add(querypart("name", VIDEO_FILE.getName()));
url.add(querypart("profile", "ugcfx/bup"));
url.add(querypart("uploadId", postVideoMeta.get("upload_id").getAsString()));
url.add(querypart("biz_id", preuploadVideo.get("biz_id").getAsString()));
JsonArray parts = new JsonArray();
for (int i = 1; i <= chunks; i++) {
JsonObject part = new JsonObject();
part.addProperty("partNumber", i);
part.addProperty("eTag", "etag");
parts.add(part);
}
JsonObject body = new JsonObject();
body.add("parts", parts);
HttpURLConnection conn = conn(url.toString(), "POST");
conn.setRequestProperty("X-Upos-Auth", preuploadVideo.get("auth").getAsString());
conn.setRequestProperty("Content-Type", "application/json; charset=UTF-8");
conn.setDoOutput(true);
conn.getOutputStream().write(body.toString().getBytes(StandardCharsets.UTF_8));
System.out.println("POST " + url.toString());
String response = new String(inputStreamToString(conn), StandardCharsets.UTF_8);
try {
JsonObject json = GSON.fromJson(response, JsonObject.class);
System.out.println(GSON.toJson(json));
} catch (JsonSyntaxException e) {
System.out.println(response);
throw e;
}
}
}
```
Reference in New Issue View Git Blame Copy Permalink