bilibili-API-collect/docs/login/login_action
Session小胡 1e24c6b188
调整部分接口描述与错误修复 (#1088)
* fix(search/search_request.md): cookie buvid3

* feat(login/login_action/password.md): more sms desc

* fix: typo

* feat(live/info.md): add ps for getRoomBaseInfo

* fix(danmaku/action.md): broken form

* chore: Browserslist: caniuse-lite is outdated

* feat(comment/list.md): reply/wbi/main param next

* feat(misc/buvid3_4.md): get buvid3 only

* fix: broken links & wrong code type

* feat: close all img & br tags

* feat(login/cookie_refresh.md): missing demo links

* feat(dynamic/detail.md): /lottery_svr/v1/lottery_svr/lottery_notice

* fix(video/action.md): share cookie buvid3

* feat: deprecated stat & attribute

* feat(dynamic/detail.md): reaction

* feat(misc/sign/v_voucher.md): header

* feat(dynamic/detail.md): update detail params & example

* feat(APP_widget/ver.md): /x/v2/version

* feat(video/info.md): update view

* feat(docs/user.md): remove channel

* feat(search/search_request.md): search/type -1200

* feat(user/space.md): audio

* feat(video/player.md): /x/player/wbi/v2

* feat(audio/musicstream_url.md): update web/url

* feat(comment/readme.md): state

* fix(user/medal.md): wrong guard_level desc

* feat(live/message_stream.md): DANMU_MSG

* fix(user/medals): wrong guard_level & guard_icon desc

* feat(live/message_stream.md): format & add more 'cmd'

* feat(live/message_stream.md): add more 'cmd'

* feat(live/message_stream.md): add tips for non-login users

* feat(video/player.md): need_login_subtitle

---------

Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
2024-09-19 23:17:33 +08:00
..
password.md 调整部分接口描述与错误修复 (#1088) 2024-09-19 23:17:33 +08:00
QR.md fix: 错误的显示和链接和数据类型 (#954) 2024-01-29 17:26:57 +08:00
readme.md feat: 各种接口补充与错误修正 (#1066) 2024-08-21 19:02:39 +08:00
SMS.md 添加app短信登录接口 (#685) 2023-05-26 10:33:03 +08:00

登录操作

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

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

扫码登录

验证登录

人机验证流程:

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

申请captcha验证码

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

请求方式GET

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

json回复

根对象:

字段 类型 内容 备注
code num 返回值 0成功
message str 返回信息
ttl num 1
data obj 信息本体

data对象:

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

geetest对象:

字段 类型 内容 备注
gt str 极验id 一般为固定值
challenge str 极验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参数:

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

JSON回复:

根对象:

字段 类型 内容 备注
code num 返回值 0成功
data obj 信息本体

data对象:

字段 类型 内容 备注
result obj 套了个娃
type num 1 作用尚不明确

result对象:

字段 类型 内容 备注
success num 1 作用尚不明确
gt str 极验id 一般为固定值
challenge str 极验KEY 由B站后端产生用于人机验证
key str 登录秘钥 与 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返回的gtchallenge
  2. 点击按钮3稍等加载验证码点击按钮4进行验证
  3. 验证完成后点击按钮5生成验证结果
  4. 使用最开始获得到的keychallenge和刚获得到的validateseccode继续之后的登录操作

继续登录