From 70eb85210189c3b0a29ebaeb0480436b85a3f2ae Mon Sep 17 00:00:00 2001
From: Kro <Admin@fungit.org>
Date: Wed, 10 Jul 2024 04:40:36 -0700
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=20=E5=BC=80=E9=80=9A?=
 =?UTF-8?q?=E7=9B=B4=E6=92=AD=E9=97=B4=20(#1050)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

开通直播间API
---
 docs/live/manage.md | 78 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)

diff --git a/docs/live/manage.md b/docs/live/manage.md
index e8b59b7c86..9aac690f65 100644
--- a/docs/live/manage.md
+++ b/docs/live/manage.md
@@ -1,5 +1,83 @@
 # 直播间管理
 
+## 开通直播间
+
+> https://api.live.bilibili.com/xlive/app-blink/v1/preLive/CreateRoom
+
+*请求方式：POST*
+
+认证方式：Cookie（SESSDATA）
+
+鉴权方式：Cookie中`bili_jct`的值正确并与`csrf`相同
+
+**正文参数（ application/x-www-form-urlencoded ）：**
+| 参数名  | 类型 | 内容                     | 必要性 | 备注                 |
+| ------- | ---- | ------------------------ | ------ | -------------------- |
+| platform | str  | 客户端？                 | 必要   | 默认值web |
+| visit_id   | str  | 未知               |        | 默认空           |
+| csrf    | str  | CSRF Token（位于cookie） | 必要   |                      |
+| csrf_token | str  | CSRF Token（位于 cookie） |     |                       |
+
+
+**json回复：**
+
+根对象：
+
+| 字段    | 类型   | 内容     | 备注                                                   |
+| ------- | ------ | -------- | ------------------------------------------------------ |
+| code    | num    | 返回值   | 0：成功<br />1531193016：已经创建直播间~<br />-400：请求错误 |
+| ttl     | str    | 错误信息 | 默认为1                                               |
+| message | str    | 错误信息 | 默认为0                                               |
+| data    | array | 信息本体       |                                                        |
+
+`data`对象：
+
+| 字段      | 类型  | 内容             | 备注                   |
+| --------- | ----- | ---------------- | ---------------------- |
+| roomID    | str   | 直播间房间号     | 创建成功返回直播间号 |
+
+**示例：**
+
+开通直播间
+
+```shell
+curl 'https://api.live.bilibili.com/xlive/app-blink/v1/preLive/CreateRoom' \
+--data-urlencode 'platform=web' \
+--data-urlencode 'visit_id=' \
+--data-urlencode 'csrf=xxx' \
+--data-urlencode 'csrf_token=xxx' \
+-b 'SESSDATA=xxx;bili_jct=xx'
+```
+
+<details>
+<summary>查看响应示例：</summary>
+
+```json
+{
+  "code": 0,
+  "message": "0",
+  "ttl": 1,
+  "data": {
+    "roomID": "1234"
+  }
+}
+```
+
+```json
+{
+  "code": 1531193016,
+  "message": "已经创建直播间~",
+  "ttl": 1,
+  "data": {
+    "roomID": ""
+  }
+}
+```
+
+</details>
+
+
+
 ## 更新直播间标题
 
 > https://api.live.bilibili.com/room/v1/Room/update