POST公开旧版B站扫码登录Cookie刷新迁移vv1

B站 Cookie 自动刷新(旧版)

迁移自旧 BilibiliCookie:默认生成 B 站扫码登录二维码(PNG base64,网关补 /v1/media 链接),method=cookie 轮询扫码结果并返回登录 Cookie,method=refresh 走 cookie/info → RSA-OAEP correspondPath → refresh → confirm 全流程换新 Cookie。

/api/BilibiliCookie
在线调试
频率限制按方案
每日额度按方案
所需权限无

接口说明

迁移自旧 BilibiliCookie:默认生成 B 站扫码登录二维码(PNG base64,网关补 /v1/media 链接),method=cookie 轮询扫码结果并返回登录 Cookie,method=refresh 走 cookie/info → RSA-OAEP correspondPath → refresh → confirm 全流程换新 Cookie。

请求参数

请求体为 JSON;未在接口定义中列出的字段一般会被忽略,但个别 Provider 单独校验的接口仍可能拒绝未声明字段;已定义字段仍会做类型、长度与枚举校验。

字段类型说明
0string旧数字路由参数:method
typestring旧返回格式参数;新平台统一返回 JSON
Cookiestringcookie 的别名(旧参数大小写兼容)
actionstring旧路径参数别名:/v1/gateway/legacy-bilibilicookie/<action>
cookiestringmethod=refresh 必填:完整 Cookie 字符串,至少包含 SESSDATA 与 bili_jct(缺失返回 -16)
methodstringdefault/缺省=生成二维码,cookie=轮询扫码结果,refresh=刷新 Cookie
qrcodeKeystringqrcode_key 的别名
cookie_strstringcookie 的别名(上一轮返回的 cookie_str 可直接回填)
qrcode_keystringmethod=cookie 必填:默认模式返回的 qrcode_key(缺失返回 -15)
refreshTokenstringrefresh_token 的别名
ac_time_valuestringrefresh_token 的别名(B 站 Cookie 里的字段名)
refresh_tokenstringmethod=refresh 必填:扫码轮询返回的 refresh_token(缺失返回 -17)

返回参数

成功响应中 data 内的字段(不含信封的 code / message / meta)。未列出的字段可能随版本增加,请忽略未知字段。

请求示例

request.json
{}

返回示例

response.json
{
  "code": 1,
  "data": {
    "content": "https://account.bilibili.com/h5/account-h5/auth/scan-web?…",
    "login_url": "https://account.bilibili.com/h5/account-h5/auth/scan-web?…",
    "qrcode_key": "c52b8e6b2b057344a0f37cfbf4674a16"
  },
  "message": {
    "url": "https://…/v1/media/…",
    "base64": "<二维码 PNG base64>",
    "contentType": "image/png"
  }
}

所有接口统一返回 { code, message, data, error_code?, details?, meta }。 成功 code = 1;失败 code 为唯一负数(如 -10001)并给出结构化 error_code, 错误码说明 →