返回提交历史
Modified
docs/live/manage.md
+78
-0
XFEstudio/bilibili-API-collect
添加 开通直播间 (#1050)
开通直播间API
70eb852
代码差异
1 个文件
+78
-0
@@ -1,5 +1,83 @@
1
1
# 直播间管理
2
2
3
## 开通直播间
4
5
> https://api.live.bilibili.com/xlive/app-blink/v1/preLive/CreateRoom
6
7
*请求方式：POST*
8
9
认证方式：Cookie（SESSDATA）
10
11
鉴权方式：Cookie中`bili_jct`的值正确并与`csrf`相同
12
13
**正文参数（ application/x-www-form-urlencoded ）：**
14
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
15
| ------- | ---- | ------------------------ | ------ | -------------------- |
16
| platform | str | 客户端？ | 必要 | 默认值web |
17
| visit_id | str | 未知 | | 默认空 |
18
| csrf | str | CSRF Token（位于cookie） | 必要 | |
19
| csrf_token | str | CSRF Token（位于 cookie） | | |
20
21
22
**json回复：**
23
24
根对象：
25
26
| 字段 | 类型 | 内容 | 备注 |
27
| ------- | ------ | -------- | ------------------------------------------------------ |
28
| code | num | 返回值 | 0：成功<br />1531193016：已经创建直播间~<br />-400：请求错误 |
29
| ttl | str | 错误信息 | 默认为1 |
30
| message | str | 错误信息 | 默认为0 |
31
| data | array | 信息本体 | |
32
33
`data`对象：
34
35
| 字段 | 类型 | 内容 | 备注 |
36
| --------- | ----- | ---------------- | ---------------------- |
37
| roomID | str | 直播间房间号 | 创建成功返回直播间号 |
38
39
**示例：**
40
41
开通直播间
42
43
```shell
44
curl 'https://api.live.bilibili.com/xlive/app-blink/v1/preLive/CreateRoom' \
45
--data-urlencode 'platform=web' \
46
--data-urlencode 'visit_id=' \
47
--data-urlencode 'csrf=xxx' \
48
--data-urlencode 'csrf_token=xxx' \
49
-b 'SESSDATA=xxx;bili_jct=xx'
50
```
51
52
<details>
53
<summary>查看响应示例：</summary>
54
55
```json
56
{
57
"code": 0,
58
"message": "0",
59
"ttl": 1,
60
"data": {
61
"roomID": "1234"
62
}
63
}
64
```
65
66
```json
67
{
68
"code": 1531193016,
69
"message": "已经创建直播间~",
70
"ttl": 1,
71
"data": {
72
"roomID": ""
73
}
74
}
75
```
76
77
</details>
78
79
80
3
81
## 更新直播间标题
4
82
5
83
> https://api.live.bilibili.com/room/v1/Room/update