返回提交历史
Modified
docs/live/manage.md
+170
-0
XFEstudio/bilibili-API-collect
:sparkles: feat(直播间管理 API): 添加更新公告与标签 API (#752)
8ba7860
代码差异
1 个文件
+170
-0
@@ -258,3 +258,173 @@ curl 'https://api.live.bilibili.com/room/v1/Room/stopLive' \
258
258
```
259
259
260
260
</details>
261
262
263
## 更新直播间公告
264
265
> https://api.live.bilibili.com/xlive/app-blink/v1/index/updateRoomNews
266
267
*请求方式：POST*
268
269
认证方式：Cookie（SESSDATA）
270
271
鉴权方式：Cookie中`bili_jct`的值正确并与`csrf`相同
272
273
**正文参数（ application/x-www-form-urlencoded ）：**
274
275
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
276
| ------- | ---- | ------------------------ | ------ | --------------------- |
277
| room_id | num | 直播间id | 必要 | 必须为自己的直播间id |
278
| uid | num | 用户id | 必要 | |
279
| content | str | 公告内容 | 必要 | 最大60个字符,可以为空 |
280
| csrf | str | CSRF Token（位于cookie） | 必要 | |
281
｜csrf_token｜str｜CSRF Token（位于cookie）｜必要｜｜
282
283
**json回复：**
284
285
根对象：
286
287
| 字段 | 类型 | 内容 | 备注 |
288
| ------- | ----- | -------- | ------------------------------------------------------ |
289
| code | num | 返回值 | 0：成功<br />65530：token错误（登录错误）<br />1：错误 |
290
| data | array | 空 | |
291
| message | str | 错误信息 | 默认为ok |
292
｜ttl｜num｜1｜作用尚不明确｜
293
294
**示例：**
295
296
修改直播间`11996900`公告为`测试修改公告`
297
298
```shell
299
curl 'https://api.live.bilibili.com/xlive/app-blink/v1/index/updateRoomNews' \
300
--data-urlencode 'room_id=11996900' \
301
--data-urlencode 'uid=306903238' \
302
--data-urlencode 'content=测试修改公告' \
303
--data-urlencode 'csrf_token=xxx' \
304
--data-urlencode 'csrf=xxx' \
305
-b 'SESSDATA=xxx;bili_jct=xxx'
306
```
307
308
<details>
309
<summary>查看响应示例：</summary>
310
311
```json
312
{
313
"code": 0,
314
"message": "0",
315
"ttl": 1,
316
"data": {}
317
}
318
```
319
320
</details>
321
322
## 编辑直播间标签
323
324
> https://api.live.bilibili.com/room/v1/Room/update
325
326
*请求方式：POST*
327
328
认证方式：Cookie（SESSDATA）
329
330
鉴权方式：Cookie中`bili_jct`的值正确并与`csrf`相同
331
332
**正文参数（ application/x-www-form-urlencoded ）：**
333
334
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
335
| ------- | ---- | ------------------------ | ------ | -------------------- |
336
| room_id | num | 直播间id | 必要 | 必须为自己的直播间id |
337
| add_tag | str | 要添加的标签 | 必要 | 最大10个字符 |
338
| del_tag | str | 要删除的标签 | 必要 | |
339
| csrf | str | CSRF Token（位于cookie） | 必要 | |
340
｜csrf_token｜str｜CSRF Token（位于cookie）｜必要｜｜
341
342
**json回复：**
343
344
根对象：
345
346
| 字段 | 类型 | 内容 | 备注 |
347
| ------- | ---- | -------- | ------------------------------------------------------ |
348
| code | num | 返回值 | 0：成功<br />65530：token错误（登录错误）<br />1：错误 |
349
| data | obj | | |
350
| message | str | 错误信息 | 默认为ok |
351
| msg | str | 错误信息 | 默认为ok |
352
353
`data`对象：
354
355
| 字段 | 类型 | 内容 | 备注 |
356
| --------------- | ---- | ---- | ---- |
357
| audit_info | obj | | |
358
| sub_session_key | str | | |
359
360
`data`中的`audit_info`对象：
361
362
| 字段 | 类型 | 内容 | 备注 |
363
| ------------------ | ---- | ---- | ---- |
364
| audit_title_reason | str | | |
365
| audit_title_status | num | 0 | |
366
| update_title | str | | |
367
368
**示例：**
369
370
给直播间`11996900`添加一个标签为`测试标签`
371
372
```shell
373
curl 'https://api.live.bilibili.com/room/v1/Room/update' \
374
--data-urlencode 'room_id=11996900' \
375
--data-urlencode 'add_tag=测试标签' \
376
--data-urlencode 'csrf_token=xxx' \
377
--data-urlencode 'csrf=xxx' \
378
-b 'SESSDATA=xxx;bili_jct=xxx'
379
```
380
381
<details>
382
<summary>查看响应示例：</summary>
383
384
```json
385
{
386
"code": 0,
387
"msg": "ok",
388
"message": "ok",
389
"data": {
390
"sub_session_key": "",
391
"audit_info": {
392
"audit_title_reason": "",
393
"update_title": "",
394
"audit_title_status": 0
395
}
396
}
397
}
398
```
399
400
给直播间`11996900`删除内容为`测试标签`的标签
401
402
```shell
403
curl 'https://api.live.bilibili.com/room/v1/Room/update' \
404
--data-urlencode 'room_id=11996900' \
405
--data-urlencode 'del_tag=测试标签' \
406
--data-urlencode 'csrf_token=xxx' \
407
--data-urlencode 'csrf=xxx' \
408
-b 'SESSDATA=xxx;bili_jct=xxx'
409
```
410
411
<details>
412
<summary>查看响应示例：</summary>
413
414
```json
415
{
416
"code": 0,
417
"msg": "ok",
418
"message": "ok",
419
"data": {
420
"sub_session_key": "",
421
"audit_info": {
422
"audit_title_reason": "",
423
"update_title": "",
424
"audit_title_status": 0
425
}
426
}
427
}
428
```
429
430
</details>