直播投票

查询投票信息

https://api.live.bilibili.com/xlive/app-room/v1/dm/interaction/votePanel

请求方法: GET

认证方式: Cookie (SESSDATA)

url参数：

参数名类型内容必要性备注
room_idnum直播间id必要必须为登录信息对应的直播间

json回复：

根对象：

字段类型内容备注
codenum返回值-400：请求错误
-101：未登录
0：成功
messagestr错误信息成功时为"0"
ttlnum1
dataobj信息本体不是登录信息对应的直播间时将为 null

data 对象：

字段类型内容备注
vote_infoobj当前活动的投票信息若当前没有活动的投票将为空对象
templatesarr投票模板

data.vote_info 对象：

字段类型内容备注
statusnum投票状态见投票状态枚举
questionstr投票问题
optionsarr投票选项
durationnum投票持续时间单位:毫秒
resultnum投票结果偏向哪一方状态
result_textstr投票结果偏向哪一方
etime_strstr投票结束时间
left_durationnum投票剩余时间单位:毫秒，投票结束后不存在
interaction_idnum投票互动id
template_idnum投票模板id使用模板时存在

data.vote_info.options 数组：

索引类型内容备注
0obj投票选项1
1obj投票选项2

data.vote_info.options 数组中对象：

字段类型内容备注
idxnum选项id
descstr投票选项描述
percentnum投票选项占比显示

data.templates 数组：

索引类型内容备注
0obj投票模板信息
…obj投票模板信息

data.templates 数组中对象：

字段类型内容备注
template_idnum模板id
questionstr投票问题
option_astr投票选项A
option_bstr投票选项B

示例：

查询投票信息

curl 'https://api.live.bilibili.com/xlive/app-room/v1/dm/interaction/votePanel?room_id=1'
查看响应示例：
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "vote_info": {
      "status": 4,
      "question": "醒醒",
      "options": [
        {
          "idx": 1,
          "desc": "醒",
          "percent": 0.5
        },
        {
          "idx": 2,
          "desc": "睡",
          "percent": 0.5
        }
      ],
      "duration": 600000,
      "result": 1,
      "result_text": "平局",
      "etime_str": "08-31 15:44",
      "left_duration": 549660,
      "interaction_id": 120122595433984
    },
    "templates": [
      {
        "template_id": 54339003518976,
        "question": "哪边赢",
        "option_a": "左",
        "option_b": "右"
      },
      {
        "template_id": 48570973661696,
        "question": "只因你太美唱的好吗？",
        "option_a": "你干嘛",
        "option_b": "哎哟"
      },
      // 省略了大部分内容
      {
        "template_id": 46203444257280,
        "question": "№！",
        "option_a": "虾头",
        "option_b": "抽象"
      },
      {
        "template_id": 96177095781888,
        "question": "相信奇迹吗",
        "option_a": "相信",
        "option_b": "必须相信"
      },
      {
        "template_id": 103827382481920,
        "question": "1",
        "option_a": "1",
        "option_b": "1"
      }
    ]
  }
}

查询投票历史

https://api.live.bilibili.com/xlive/app-room/v1/dm/interaction/voteHistory

请求方法: GET

认证方式: Cookie (SESSDATA)

url参数：

参数名类型内容必要性备注
room_idnum直播间id必要必须为登录信息对应的直播间

json回复：

根对象：

字段类型内容备注
codenum返回值-400：请求错误
-101：未登录
0：成功
messagestr错误信息成功时为"0"
ttlnum1
dataobj信息本体不是登录信息对应的直播间时将为空对象

data 对象：

字段类型内容备注
historyarr投票历史列表

data.history 数组：

索引类型内容备注
0obj投票历史与查询投票信息data.vote_info相同
…obj投票历史与查询投票信息data.vote_info相同
9obj投票历史与查询投票信息data.vote_info相同

data.history 数组中对象：

与 查询投票信息 json回复的 data.vote_info 相同。

示例：

curl 'https://api.live.bilibili.com/xlive/app-room/v1/dm/interaction/voteHistory?room_id=1' \
  -b 'SESSDATA=xxx'
查看响应示例：
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": {
    "history": [
      {
        "status": 5,
        "question": "醒醒",
        "options": [
          {
            "idx": 1,
            "desc": "醒",
            "percent": 0.5
          },
          {
            "idx": 2,
            "desc": "睡",
            "percent": 0.5
          }
        ],
        "duration": 600000,
        "result": 1,
        "result_text": "平局",
        "etime_str": "08-31 15:44",
        "interaction_id": 120122595433984
      },
      {
        "status": 5,
        "question": "会不会睡死？",
        "options": [
          {
            "idx": 1,
            "desc": "包会的",
            "percent": 0.5
          },
          {
            "idx": 2,
            "desc": "不会的",
            "percent": 0.5
          }
        ],
        "duration": 60000,
        "result": 1,
        "result_text": "平局",
        "etime_str": "08-31 14:57",
        "interaction_id": 120117830648832
      },
      {
        "status": 5,
        "question": "会不会睡着？",
        "options": [
          {
            "idx": 1,
            "desc": "包会的",
            "percent": 0.5
          },
          {
            "idx": 2,
            "desc": "不会的",
            "percent": 0.5
          }
        ],
        "duration": 180000,
        "result": 1,
        "result_text": "平局",
        "etime_str": "08-31 14:53",
        "interaction_id": 120117121798656
      },
      {
        "status": 5,
        "question": "能不能一把过",
        "options": [
          {
            "idx": 1,
            "desc": "能",
            "percent": 0.5
          },
          {
            "idx": 2,
            "desc": "不能",
            "percent": 0.5
          }
        ],
        "duration": 60000,
        "result": 1,
        "result_text": "平局",
        "etime_str": "08-31 14:41",
        "interaction_id": 120115796409344,
        "template_id": 3109187328000
      }
      // 省略其余6项
    ]
  }
}

投票状态

此处列出已发现的投票状态，在投票信息和直播信息流 DM_INTERACTION 的类型 101 等地方使用。

当前状态信息来自混淆代码寻找而来。

值含义备注
0键名 NONE
1等待审核键名 WAITING_AUDIT
2审核失败键名 AUDIT_FAILED
4投票进行中键名 DURING
5投票结束键名 END
6键名 STOP

创建直播投票

https://api.live.bilibili.com/xlive/app-room/v1/dm/interaction/createVote

请求方法: POST

认证方式: Cookie (SESSDATA)

鉴权方式: Cookie中bili_jct的值正确并与csrf相同

投票创建完成后，投票信息和审核结果将以直播信息流 DM_INTERACTION 的类型 101 下发。

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

参数名类型内容必要性备注
room_idnum直播间id必要必须为登录信息对应的直播间
durationnum持续时间必要必须为整数，目前范围0<d<10
questionstr投票问题必要
option_astr选项A必要
option_bstr选项B必要
template_idnum投票模板id非必要
live_keystr直播场次key非必要需要更多信息
sub_session_keystr(?)非必要需要更多信息
csrf_tokenstrCSRF Token（位于cookie）非必要
csrfstrCSRF Token（位于cookie）必要
visit_idstr(?)非必要作用尚不明确

json回复：

根对象：

字段类型内容备注
codenum返回值-404：不是自己的直播间
-400：参数错误
-101：未登录
-111：csrf校验失败
0：成功
messagestr错误信息成功时为"0"
ttlnum1
dataobj信息本体

data 对象：

字段类型内容备注
interaction_idnum投票互动id

示例：

创建一个投票

curl 'https://api.live.bilibili.com/xlive/app-room/v1/dm/interaction/createVote' \
  --data-urlencode 'room_id=3' \
  --data-urlencode 'duration=1' \
  --data-urlencode 'question=abcdef' \
  --data-urlencode 'option_a=A' \
  --data-urlencode 'option_b=B' \
  --data-urlencode 'csrf=xxx' \
  -b 'SESSDATA=xxx;bili_jct=xxx'
查看响应示例：
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data":{
    "interaction_id":120008099262976
  }
}

中断直播投票

https://api.live.bilibili.com/xlive/app-room/v1/dm/interaction/terminateVote

请求方法: POST

认证方式: Cookie (SESSDATA)

鉴权方式: Cookie中bili_jct的值正确并与csrf相同

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

参数名类型内容必要性备注
interaction_idnum投票互动id必要必须为该登录信息创建的投票
room_idnum直播间id必要必须为登录信息对应的直播间
csrf_tokenstrCSRF Token（位于cookie）非必要
csrfstrCSRF Token（位于cookie）必要
visit_idstr(?)非必要作用尚不明确

json回复：

根对象：

字段类型内容备注
codenum返回值-400：参数错误
-101：未登录
-111：csrf校验失败
0：成功
1003402：修改投票状态失败
messagestr错误信息成功时为"0"
ttlnum1
datanull无

示例：

中断某个投票

curl 'https://api.live.bilibili.com/xlive/app-room/v1/dm/interaction/terminateVote' \
  --data-urlencode 'interaction_id=120122595433984' \
  --data-urlencode 'room_id=1' \
  --data-urlencode 'csrf=xxx' \
  -b 'SESSDATA=xxx;bili_jct=xxx'
查看响应示例：
{
  "code": 0,
  "message": "0",
  "ttl": 1,
  "data": null
}

弹幕投票主播侧界面

https://live.bilibili.com/p/html/live-app-guessing-game/anchor_vote.html

直接访问此页面存在部分功能不可用的情况。

URL查询参数：

参数名类型内容必要性备注
room_idnum直播间id必要必须为自己的直播间