登录操作

人机验证方式登录包含账号密码登录与手机短信验证码登录

注：扫码登录不需要进行人机验证，故不使用以下接口

扫码登录

验证登录

人机验证流程：

  1. 请求验证码参数，得到登录密钥key与极验idgt和极验KEYchallenge
  2. 进行滑动or点击验证
  3. 返回验证结果validate与seccode，进行短信或密码登录

申请captcha验证码

https://passport.bilibili.com/x/passport-login/captcha?source=main_web

请求方式：GET

注: 另外参见 密码登录-手机号验证-获取 captcha

json回复：

根对象：

字段类型内容备注
codenum返回值0：成功
messagestr返回信息
ttlnum1
dataobj信息本体

data对象：

字段类型内容备注
geetestobj极验captcha数据
tencentobj(?)作用尚不明确
tokenstr登录 API token与 captcha 无关，与登录接口有关
typestr验证方式用于判断使用哪一种验证方式，目前所见只有极验
geetest：极验

geetest对象：

字段类型内容备注
gtstr极验id一般为固定值
challengestr极验KEY由B站后端产生用于人机验证

示例：

curl 'https://passport.bilibili.com/x/passport-login/captcha?source=main_web'
查看响应示例：
{
    "code": 0,
    "message": "0",
    "ttl": 1,
    "data": {
        "type": "geetest",
        "token": "00fbe75cc2864ba0af969231f193a974",
        "geetest": {
            "challenge": "a57d9be17505d4a15ed84694c48fbf74",
            "gt": "ac597a4506fee079629df5d8b66dd4fe"
        },
        "tencent": {
            "appid": ""
        }
    }
}

申请captcha验证码 (旧版)

http://passport.bilibili.com/web/captcha/combine

请求方式：GET

该接口曾从文档移除过, 经过测试仍可正常使用

URL参数:

参数名类型内容必要性备注
platnum平台类型必要默认为 6

JSON回复:

根对象：

字段类型内容备注
codenum返回值0：成功
dataobj信息本体

data对象：

字段类型内容备注
resultobj套了个娃
typenum1作用尚不明确

result对象：

字段类型内容备注
successnum1作用尚不明确
gtstr极验id一般为固定值
challengestr极验KEY由B站后端产生用于人机验证
keystr登录秘钥与 captcha 无关, 与登录接口有关, 亦作 token

示例:

curl 'https://passport.bilibili.com/web/captcha/combine?plat=6'
查看响应示例：
{
  "code": 0,
  "data": {
    "result": {
      "success": 1,
      "gt": "bd111e81eda1cbb9f54425aafc0908ac",
      "challenge": "2903a8eb967a1d990444cb23ea42f417",
      "key": "76fb59fbd83a4d9d816162c5156fc964"
    },
    "type": 1
  }
}

进行验证

本文档为 Bilibili 文档，验证码为 geetest 极验 提供，故不提供相关 API

附: 手动验证器及其源码

  1. 打开手动验证器，在1、2分别填入上面API返回的gt和challenge
  2. 点击按钮3，稍等加载验证码，点击按钮4进行验证
  3. 验证完成后，点击按钮5生成验证结果
  4. 使用最开始获得到的key、challenge和刚获得到的validate、seccode继续之后的登录操作

继续登录