Skip to content

Commit a245b81

Browse files
Roberta001z0z0r4
Roberta001
and
z0z0r4
authored
更新开始直播 api 鉴权和更新直播姬版本号获取接口 (#1351)
* Update manage.md * Update manage.md * Update manage.md * Update manage.md * Update manage.md * Update manage.md * Update manage.md * Update manage.md * Update manage.md * Update manage.md * style: format 适当加上空格观感好点 --------- Co-authored-by: z0z0r4 <[email protected]>
1 parent 80b96ee commit a245b81

File tree

1 file changed

+92
-8
lines changed

1 file changed

+92
-8
lines changed

‎docs/live/manage.md

Lines changed: 92 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@
1111
鉴权方式：Cookie中`bili_jct`的值正确并与`csrf`相同
1212

1313
**正文参数（ application/x-www-form-urlencoded ）：**
14+
1415
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
1516
| ------- | ---- | ------------------------ | ------ | -------------------- |
1617
| platform | str | 客户端？ | 必要 | 默认值web |
@@ -270,23 +271,31 @@ curl 'https://api.live.bilibili.com/room/v1/Room/update' \
270271

271272
**正文参数（ application/x-www-form-urlencoded ）：**
272273

273-
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
274-
| -------- | ---- | ------------------------ | ------ | ----------------------------------- |
275-
| room_id | num | 直播间id | 必要 | 必须为自己的直播间id |
276-
| area_v2 | num | 直播分区id（子分区id） | 必要 | 详见[直播分区](live_area.md) |
277-
| platform | str | 直播平台 | 必要 | 直播姬（pc）：pc_link<br />直播姬（android）：android_link |
278-
| csrf | str | CSRF Token（位于cookie） | 必要 | |
274+
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
275+
| -------- | ---- | ------------------------ | ------ | ------------------------------------------------------------ |
276+
| room_id | num | 直播间id | 必要 | 必须为自己的直播间 id |
277+
| area_v2 | num | 直播分区id（子分区 id） | 必要 | 详见[直播分区](live_area.md) |
278+
| platform | str | 直播平台 | 必要 | 可选值：`pc`、`pc_link` (直播姬 PC), `android_link` (直播姬 Android) |
279+
| csrf | str | CSRF Token（位于 cookie） | 必要 | |
280+
| csrf_token | str | CSRF Token（位于 cookie） | 非必要 | |
281+
| version | str | 直播姬版本号 | 非必要 | 建议与 `build` 一同提供，详见下方说明。可从[直播姬版本号获取](#直播姬版本号获取)接口获得。 |
282+
| build | num | 直播姬构建号 | 非必要 | 建议与 `version` 一同提供。 |
283+
| appkey | str | APP密钥 | 条件性必要 | 特定情况下必要，详见下方说明。 |
284+
| sign | str | APP API签名得到的 sign | 条件性必要 | 特定情况下必要，详见下方说明。 |
285+
286+
**说明**: 截止至 2025 年 7 月 20 日，部分账户不提供 `version` `build` `appkey` `sign` 也可获取推流码，部分账户会返回 `60024` (需要人脸认证)，此时请尝试提供 `version` `build`，目前似乎没有校验，提供了就可以。(比如 `version:1.0.0` `build:1234`) 如果仍然返回 `60024`，请尝试提供 `appkey` `sign` 参数。如果你的 `version` 和 `build` 为 `7.19.0.9432` 和 `9432`，必须提供 `appkey` `sign`。
279287

280288
**json回复：**
281289

282290
根对象：
283291

284292
| 字段 | 类型 | 内容 | 备注 |
285293
| ------- | ---- | -------- | ------------------------------------------------------------ |
286-
| code | num | 返回值 | 0：成功<br />65530：token错误（登录错误）<br />1：错误<br />60009：分区不存在<br />60013：非常抱歉，您所在的地区受实名认证限制无法开播<br />60024: 目标分区需要人脸认证<br />60034: 系统维护仅支持直播姬开播<br />60037: web 在线开播已下线<br />**（其他错误码有待补充）** |
294+
| code | num | 返回值 | 0: 成功<br />-400: 请求错误<br />1: 错误<br />60009: 分区不存在<br />60013: 所在地区受实名认证限制无法开播<br />60024: 目标分区需要人脸认证<br />60034: 系统维护仅支持直播姬开播<br />60037: web在线开播已下线<br />65530: token错误 (登录失效)<br />**(其他错误码有待补充)** |
287295
| msg | str | 提示信息 | 默认为空 |
288296
| message | str | 提示信息 | 默认为空 |
289-
| data | obj | 信息本体 | |
297+
| data | obj | 信息本体 | 成功时返回 |
298+
290299

291300
`data`对象：
292301

@@ -656,3 +665,78 @@ curl 'https://api.live.bilibili.com/xlive/app-blink/v1/index/updateRoomNews' \
656665
```
657666

658667
</details>
668+
669+
## PC直播姬版本号获取
670+
> https://api.live.bilibili.com/xlive/app-blink/v1/liveVersionInfo/getHomePageLiveVersion
671+
672+
*请求方式：GET*
673+
674+
认证方式：无
675+
676+
鉴权方式：无
677+
678+
**请求参数 (Query)：**
679+
680+
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
681+
| ------- | ---- | ------------------------ | ------ | --------------------- |
682+
| appkey | str | APP密钥 | 不必要 |使用PC投稿工具的appkey和appsec|
683+
| sign | str | APP API签名得到的sign | 不必要 | |
684+
| system_version | num | 暂不清楚 | 必要 | 可以直接写2 |
685+
| ts | num | 10位时间戳 | 不必要 | |
686+
687+
**json回复：**
688+
689+
根对象：
690+
691+
| 字段 | 类型 | 内容 | 备注 |
692+
| ------- | ----- | -------- | ------------------------------------------------------ |
693+
| code | num | 返回值 | 0：成功<br />-400：请求错误 |
694+
| message | str | 错误信息 | 默认为0 |
695+
| ttl | num | 1 | 作用尚不明确 |
696+
| data | obj | 内容本体 | |
697+
698+
`data`对象：
699+
700+
| 字段 | 类型 | 内容 | 备注 |
701+
| --------------- | ---- | ------------------------ | ---------------------- |
702+
| curr_version | str | 直播姬最新版本号 | |
703+
| build | num | 直播姬构建号 | |
704+
| instruction | str | 更新说明（简要） | |
705+
| file_size | str | 文件大小（字节） | |
706+
| file_md5 | str | 安装包文件MD5 | |
707+
| content | str | HTML格式的更新内容 | |
708+
| download_url | str | 安装包下载链接 | |
709+
| hdiffpatch_switch | num | 增量更新开关? | |
710+
711+
**示例：**
712+
713+
获取直播姬最新版本信息
714+
715+
```shell
716+
curl 'https://api.live.bilibili.com/xlive/app-blink/v1/liveVersionInfo/getHomePageLiveVersion?appkey=aae92bc66f3edfab&sign=49d289e3ad34c509cc66fbee1c0affec&system_version=2&ts=1752971145'
717+
```
718+
719+
<details>
720+
<summary>查看响应示例：</summary>
721+
722+
```json
723+
{
724+
"code": 0,
725+
"message": "0",
726+
"ttl": 1,
727+
"data": {
728+
"curr_version": "7.19.0.9432",
729+
"build": 9432,
730+
"instruction": "\u3010\u65b0\u589e\u3011\u65b0\u589e\u7f8e\u989c\u8c03\u6574\u5165\u53e3\n\u3010\u4f18\u5316\u3011\u5df2\u77e5\u95ee\u9898\u4f18\u5316",
731+
"file_size": "300867136",
732+
"file_md5": "e1619a8e2603aa94b58a58121f94403f",
733+
"content": "<p>\u3010\u65b0\u589e\u3011\u65b0\u589e\u7f8e\u989c\u8c03\u6574\u5165\u53e3<br>\u3010\u4f18\u5316\u3011\u5df2\u77e5\u95ee\u9898\u4f18\u5316</p><p></p><p><br></p>",
734+
"download_url": "https://dl.hdslb.com/bili/bililive/win/Livehime-Win-beta-7.19.0.9432-x64.exe",
735+
"hdiffpatch_switch": 1
736+
}
737+
}
738+
```
739+
740+
</details>
741+
742+

0 commit comments

Comments
 (0)