请求方式:POST
认证方式:Cookie(SESSDATA)或APP
正文参数( application/x-www-form-urlencoded ):
参数名 | 类型 | 内容 | 必要性 | 备注 |
---|---|---|---|---|
access_key | str | APP登录Token | APP方式必要 | |
dm_switch | bool | 弹幕开关 | 非必要 | true:开启 false:关闭 |
blockscroll | bool | 屏蔽类型-滚动 | 非必要 | true:不屏蔽 false:屏蔽 |
blocktop | bool | 屏蔽类型-顶部 | 非必要 | 同上 |
blockbottom | bool | 屏蔽类型-底部 | 非必要 | 同上 |
blockcolor | bool | 屏蔽类型-彩色 | 非必要 | 同上 |
blockspecial | bool | 屏蔽类型-特殊 | 非必要 | 同上 |
ai_switch | bool | 是否打开智能云屏蔽 | 非必要 | true:开启 false:关闭 |
ai_level | num | 智能云屏蔽等级 | 非必要 | 区间:[0-10] 0为默认等级(3级) |
preventshade | bool | 防挡弹幕(底部15%) | 非必要 | true:开启 false:关闭 |
dmask | bool | 智能防挡弹幕(人像蒙版) | 非必要 | 同上 |
opacity | num | 弹幕不透明度 | 非必要 | 区间:[0-1] |
dmarea | num | 弹幕显示区域 | 非必要 | 100:不重叠 75:3/4屏 50:半瓶 25:1/4屏 0:不限 |
speedplus | num | 弹幕速度 | 非必要 | 区间:[0.4-1.6] |
fontsize | num | 字体大小 | 非必要 | 区间:[0.4-1.6] |
screensync | bool | 跟随屏幕缩放比例 | 非必要 | true:开启 false:关闭 |
speedsync | bool | 根据播放倍速调整速度 | 非必要 | 同上 |
fontfamily | str | 字体类型 | 非必要 | 未启用 |
bold | bool | 粗体 | 非必要 | 未启用 |
fontborder | num | 描边类型 | 非必要 | 0:重墨 1:描边 2:45°投影 |
drawType | string | 渲染类型 | 非必要 | 未启用 |
ts | num | 当前时间戳 | 非必要 | |
csrf | str | CSRF Token(位于cookie) | Cookie方式必要 |
json回复:
根对象:
字段 | 类型 | 内容 | 备注 |
---|---|---|---|
code | num | 返回值 | 0:成功 -101:账号未登录 -111:csrf校验失败 -400:请求错误 23004:数据没有修改 |
message | str | 错误信息 | 默认为0 |
ttl | num | 1 |
示例:
关闭弹幕
curl 'https://api.bilibili.com/x/v2/dm/web/config' \
--data-urlencode 'dm_switch=false' \
--data-urlencode 'csrf=xxx' \
-b 'SESSDATA=xxx'
查看响应示例:
{
"code":0,
"message":"0",
"ttl":1
}