优化文档格式
This commit is contained in:
SocialSisterYi
179
login/login_action/QR.md
Normal file
179
login/login_action/QR.md
Normal file
@@ -0,0 +1,179 @@
|
||||
# 二维码登录
|
||||
|
||||
流程&逻辑：
|
||||
|
||||
1. 获取`二维码内容url`以及`密钥`，以`二维码内容url`生成二维码，等待手机客户端扫描
|
||||
2. 以`密钥`作为参数进行POST
|
||||
3. if "code"==true goto 6 else goto 4（是否已经确认）
|
||||
4. if "data"==-4 goto 2 else goto 5（是否已经扫描）
|
||||
5. if "data"==-5 goto 3 && 提示`已扫描`else goto 1&提示`二维码超时或错误`（密钥是否有效）
|
||||
6. 成功后会自动配置cookie 如需登录游戏分站则访问`data`.`url`中的url
|
||||
|
||||
<img src="/imgs/2233login.png"/>
|
||||
|
||||
|
||||
|
||||
## 申请二维码URL及扫码密钥
|
||||
|
||||
> http://passport.bilibili.com/qrcode/getLoginUrl
|
||||
|
||||
*请求方式：GET*
|
||||
|
||||
密钥超时为180秒
|
||||
|
||||
**json回复：**
|
||||
|
||||
根对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ------ | ---- | -------- | ------------ |
|
||||
| code | num | 返回值 | 0：成功 |
|
||||
| status | bool | true | 作用尚不明确 |
|
||||
| ts | num | 请求时间 | 时间戳 |
|
||||
| data | obj | 信息本体 | |
|
||||
|
||||
`data`对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| -------- | ----- | ------------- | ---------- |
|
||||
| url | str | 二维码内容url | 恒为87字符 |
|
||||
| oauthKey | str | 扫码登录秘钥 | 恒为32字符 |
|
||||
|
||||
**示例：**
|
||||
|
||||
用申请到的`data`.`url`中的值生成二维码，等待手机客户端扫描，并将`data`.`oauthKey`保存等待使用
|
||||
|
||||
```shell
|
||||
curl 'http://passport.bilibili.com/qrcode/getLoginUrl'
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"status": true,
|
||||
"ts": 1583314311,
|
||||
"data": {
|
||||
"url": "https://passport.bilibili.com/qrcode/h5/login?oauthKey=c3bd5286a2b40a822f5f60e9bf3f602e",
|
||||
"oauthKey": "c3bd5286a2b40a822f5f60e9bf3f602e"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 使用扫码登录（验证扫码状态）
|
||||
|
||||
> http://passport.bilibili.com/qrcode/getLoginInfo
|
||||
|
||||
*请求方式：POST*
|
||||
|
||||
密钥超时为180秒
|
||||
|
||||
验证登录成功后会进行设置以下cookie项：
|
||||
|
||||
`sid` `DedeUserID` `DedeUserID__ckMd5` `SESSDATA` `bili_jct`
|
||||
|
||||
**正文参数（ application/x-www-form-urlencoded ）：**
|
||||
|
||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||
| -------- | ---- | ------------ | ------ | ----------------------------- |
|
||||
| oauthKey | str | 扫码登录秘钥 | 必要 | |
|
||||
| gourl | str | 跳转url | 非必要 | 默认为http://www.bilibili.com |
|
||||
|
||||
**json回复：**
|
||||
|
||||
根对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ------- | ---------------------------- | ----------------------------------------- | ------------------------------------------------------------ |
|
||||
| status | bool | 扫码是否成功 | true：成功<br />false：未成功 |
|
||||
| code | num | 返回值 | 0：成功 |
|
||||
| message | str | 错误信息 | 正确无 |
|
||||
| ts | num | 扫码时间 | 错误无 |
|
||||
| data | 正确时：obj<br />错误时：num | 正确时：游戏分站url<br />错误时：错误代码 | 错误时：<br />-1：秘钥错误<br />-2：秘钥超时<br />-4：未扫描<br />-5：未确认 |
|
||||
|
||||
data 对象：
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | ------------------- | ---- |
|
||||
| url | str | 游戏分站跨域登录url | |
|
||||
|
||||
**示例：**
|
||||
|
||||
例如扫码秘钥为`23333`
|
||||
|
||||
```shell
|
||||
curl "http://passport.bilibili.com/qrcode/getLoginInfo"\
|
||||
--data-urlencode 'oauthKey=23333'\
|
||||
-c 'cookie.txt'
|
||||
```
|
||||
|
||||
当密钥正确时但未扫描时`status`为`false`，`data`为num值`-4`
|
||||
|
||||
```json
|
||||
{
|
||||
"status":false,
|
||||
"data":-4,
|
||||
"message":"Can't scan~"
|
||||
}
|
||||
```
|
||||
|
||||
扫描成功但手机端未确认时`status`为`false`，`data`为num值`-5`
|
||||
|
||||
```json
|
||||
{
|
||||
"status":false,
|
||||
"data":-5,
|
||||
"message":"Can't confirm~"
|
||||
}
|
||||
```
|
||||
|
||||
扫描成功手机端确认登录后，`status`为`true`，`data`为对象，并向浏览器写入cookie
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"status": true,
|
||||
"ts": 1583315474,
|
||||
"data": {
|
||||
"url": "https://passport.biligame.com/crossDomain?DedeUserID=***&DedeUserID__ckMd5=***&Expires=***&SESSDATA=***&bili_jct=***&gourl=http%3A%2F%2Fwww.bilibili.com"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**响应头部抓包信息：**
|
||||
|
||||
可明显看见设置了几个cookie（填入浏览器即可成功登录）
|
||||
|
||||
```http
|
||||
HTTP/1.1 200 OK
|
||||
Date: Wed, 04 Mar 2020 10:36:37 GMT
|
||||
Content-Type: application/json;charset=UTF-8
|
||||
Transfer-Encoding: chunked
|
||||
Connection: keep-alive
|
||||
Server: Apache-Coyote/1.1
|
||||
Set-Cookie: sid=***; Domain=.bilibili.com; Expires=Thu, 04-Mar-2021 10:36:37 GMT; Path=/
|
||||
Set-Cookie: DedeUserID=***; Domain=.bilibili.com; Expires=Mon, 31-Aug-2020 10:19:57 GMT; Path=/
|
||||
Set-Cookie: DedeUserID__ckMd5=***; Domain=.bilibili.com; Expires=Mon, 31-Aug-2020 10:19:57 GMT; Path=/
|
||||
Set-Cookie: SESSDATA=***; Domain=.bilibili.com; Expires=Mon, 31-Aug-2020 10:19:57 GMT; Path=/; HttpOnly
|
||||
Set-Cookie: bili_jct=***; Domain=.bilibili.com; Expires=Mon, 31-Aug-2020 10:19:57 GMT; Path=/
|
||||
Expires: Wed, 04 Mar 2020 10:36:36 GMT
|
||||
Cache-Control: no-cache
|
||||
X-Cache-Webcdn: BYPASS from ks-sxhz-dx-w-01
|
||||
```
|
||||
|
||||
**游戏分站跨域登录url：**
|
||||
|
||||
游戏分站跨域登录url与cookie的值一一对应，可用于不方便设置cookie的场合提取使用
|
||||
|
||||
https://passport.biligame.com/crossDomain?
|
||||
|
||||
DedeUserID=(登录UID)&
|
||||
|
||||
DedeUserID__ckMd5=(登录UID MD5值)&
|
||||
|
||||
Expires=(过期时间 秒)&
|
||||
|
||||
SESSDATA=(登录token)&
|
||||
|
||||
bili_jct=(csrf)&
|
||||
|
||||
gourl=(跳转网址 默认为主页)
|
||||
|
||||
219
login/login_action/SMS.md
Normal file
219
login/login_action/SMS.md
Normal file
@@ -0,0 +1,219 @@
|
||||
# 短信登录
|
||||
|
||||
web端短信登录流程：
|
||||
|
||||
1. [完成人机验证](readme.md)
|
||||
2. 发送短信，使用国际地区代码`cid`+手机号码`tel`+登录密钥`key`+极验`challenge`+验证结果`validate`+验证结果`seccode`
|
||||
3. 提交短信验证码以验证登录操作，使用国际地区代码`cid`+手机号码`tel`+短信验证码`smsCode`
|
||||
|
||||
## 获取国际地区代码（web端）
|
||||
|
||||
> http://passport.bilibili.com/web/generic/country/list
|
||||
|
||||
*请求方式：GET*
|
||||
|
||||
**json回复：**
|
||||
|
||||
根对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | -------- | ------- |
|
||||
| code | num | 返回值 | 0：成功 |
|
||||
| data | obj | 数据本体 | |
|
||||
|
||||
`data`对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ------ | ----- | -------------- | ---- |
|
||||
| common | array | 常用国家或地区 | |
|
||||
| others | array | 其他国家或地区 | |
|
||||
|
||||
`data`中的`common`和`others`数组：
|
||||
|
||||
| 项 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | --------------- | ---- |
|
||||
| 0 | obj | 国家或地区1 | |
|
||||
| n | obj | 国家或地区(n+1) | |
|
||||
| …… | obj | …… | …… |
|
||||
|
||||
`common`和`others`数组中的对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ---------- | ---- | -------------- | ---- |
|
||||
| id | num | 国际代码值 | |
|
||||
| cname | str | 国家或地区名 | |
|
||||
| country_id | str | 国家或地区区号 | |
|
||||
|
||||
**示例：**
|
||||
|
||||
```shell
|
||||
curl 'http://passport.bilibili.com/web/generic/country/list'
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"data": {
|
||||
"common": [
|
||||
{
|
||||
"id": 1,
|
||||
"cname": "中国大陆",
|
||||
"country_id": "86"
|
||||
},
|
||||
{
|
||||
"id": 5,
|
||||
"cname": "中国香港特别行政区",
|
||||
"country_id": "852"
|
||||
},
|
||||
…………
|
||||
],
|
||||
"others": [
|
||||
{
|
||||
"id": 22,
|
||||
"cname": "阿富汗",
|
||||
"country_id": "93"
|
||||
},
|
||||
{
|
||||
"id": 20,
|
||||
"cname": "阿尔巴尼亚",
|
||||
"country_id": "355"
|
||||
},
|
||||
…………
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
|
||||
## 发送短信验证码（web端）
|
||||
|
||||
> http://passport.bilibili.com/web/sms/general/v2/send
|
||||
|
||||
*请求方式：POST*
|
||||
|
||||
短信发送CD时间为60s
|
||||
|
||||
短信验证码超时时间为5min
|
||||
|
||||
**正文参数（ application/x-www-form-urlencoded ）：**
|
||||
|
||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| tel | num | 手机号码 | 必要 | |
|
||||
| cid | num | 国际地区代码 | 必要 | |
|
||||
| type | num | 21 | 必要 | 必须为`21` |
|
||||
| captchaType | num | 6 | 必要 | 必须为`6` |
|
||||
| key | str | 登录秘钥 | 必要 | 从B站API获取 |
|
||||
| challenge | str | 极验challenge | 必要 | 从B站API获取 |
|
||||
| validate | str | 极验结果 | 必要 | 从极验获取 |
|
||||
| seccode | str | 极验结果+`|jordan` | 必要 | 从极验获取 |
|
||||
|
||||
**json回复：**
|
||||
|
||||
根对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ------ | ---- | -------- | --------- |
|
||||
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />1002：手机号格式错误<br />1015：短信发送次数已达上限<br />1003：验证码已经发送<br />2400：登录秘钥错误<br />2406：验证极验服务出错 |
|
||||
| message | str | 错误信息 | 成功为"验证码短信已下发" |
|
||||
|
||||
**示例：**
|
||||
|
||||
例如手机号为`13888888888`，国际ID为`1（中国大陆）`，登录秘钥为`aabbccdd`，极验challenge为`2333`，极验结果为`666666`，进行发送短信验证码操作
|
||||
|
||||
```shell
|
||||
curl 'http://passport.bilibili.com/web/sms/general/v2/send' \
|
||||
--data-urlencode 'tel=13888888888'\
|
||||
--data-urlencode 'cid=1'\
|
||||
--data-urlencode 'type=21'\
|
||||
--data-urlencode 'captchaType=6'\
|
||||
--data-urlencode 'key=aabbccdd'\
|
||||
--data-urlencode 'challenge=2333'\
|
||||
--data-urlencode 'validate=666666'\
|
||||
--data-urlencode 'seccode=666666|jordan'
|
||||
```
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"message": "验证码短信已下发"
|
||||
}
|
||||
```
|
||||
|
||||
## 使用短信验证码登录（web端）
|
||||
|
||||
> http://passport.bilibili.com/web/login/rapid
|
||||
|
||||
*请求方式：POST*
|
||||
|
||||
验证登录成功后会进行设置以下cookie项：
|
||||
|
||||
`DedeUserID` `DedeUserID__ckMd5` `SESSDATA` `bili_jct`
|
||||
|
||||
**正文参数（ application/x-www-form-urlencoded ）：**
|
||||
|
||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| cid | num | 国际地区代码 | 必要 | |
|
||||
| tel | num | 手机号码 | 必要 | |
|
||||
| smsCode | num | 短信验证码 | 必要 | 超时时间为5min |
|
||||
| goUrl | str | 跳转url | 非必要 | 默认为https://www.bilibili.com |
|
||||
|
||||
**json回复：**
|
||||
|
||||
根对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| --- | --- | --- | --- |
|
||||
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />1006：请输入正确的短信验证码<br />1007：短信验证码已过期 |
|
||||
| message | str | 错误信息 | |
|
||||
| data | obj | 信息本体 | |
|
||||
|
||||
`data`对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| --- | --- | --- | --- |
|
||||
| is_new | bool | false | 未知,估计是未注册时自动注册新用户 |
|
||||
| status | num | 0 | 未知,可能0就是成功吧 |
|
||||
| url | str | 跳转url | 默认为https://www.bilibili.com |
|
||||
|
||||
**示例：**
|
||||
|
||||
使用手机号`13888888888`，短信验证码为`123456`，进行验证登录操作
|
||||
|
||||
```shell
|
||||
curl 'https://passport.bilibili.com/web/login/rapid'
|
||||
--data-urlencode 'cid=1'\
|
||||
--data-urlencode 'tel=13888888888'\
|
||||
--data-urlencode 'smsCode=123456'
|
||||
```
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"data": {
|
||||
"is_new": false,
|
||||
"status": 0,
|
||||
"url": "https://space.bilibili.com"
|
||||
}
|
||||
}
|
||||
```
|
||||
**响应头部抓包信息：**
|
||||
|
||||
可明显看见设置了几个cookie（填入浏览器即可成功登录）
|
||||
|
||||
```http
|
||||
HTTP/1.1 200 OK
|
||||
Date: Mon, 13 Jul 2020 09:57:33 GMT
|
||||
Content-Type: application/json;charset=UTF-8
|
||||
Content-Length: 78
|
||||
Connection: keep-alive
|
||||
Server: Apache-Coyote/1.1
|
||||
Set-Cookie: DedeUserID=***; Domain=.bilibili.com; Expires=Sat, 18-Jul-2020 09:57:57 GMT; Path=/
|
||||
Set-Cookie: DedeUserID__ckMd5=***; Domain=.bilibili.com; Expires=Sat, 18-Jul-2020 09:57:57 GMT; Path=/
|
||||
Set-Cookie: SESSDATA=***; Domain=.bilibili.com; Expires=Sat, 18-Jul-2020 09:57:57 GMT; Path=/; HttpOnly
|
||||
Set-Cookie: bili_jct=***; Domain=.bilibili.com; Expires=Sat, 18-Jul-2020 09:57:57 GMT; Path=/
|
||||
Expires: Mon, 13 Jul 2020 09:57:32 GMT
|
||||
Cache-Control: no-cache
|
||||
X-Cache-Webcdn: BYPASS from jd-sxhz-dx-w-01
|
||||
|
||||
```
|
||||
224
login/login_action/password.md
Normal file
224
login/login_action/password.md
Normal file
@@ -0,0 +1,224 @@
|
||||
# 账号密码登录
|
||||
|
||||
web端密码登录流程：
|
||||
|
||||
1. [完成人机验证](readme.md)
|
||||
2. 加密登录密码，获取RSA公钥`key`与盐值`hash`**（盐值有效时间为20s）**，并连接盐值+密码字串（注意先后顺序），使用RSA公钥加密，得到base64格式密文
|
||||
4. 登录操作验证，使用账号`username`**（手机号或邮箱）**+密文密码`password`+登录密钥`key`+极验`challenge`+验证结果`validate`+验证结果`seccode`
|
||||
|
||||
## 获取加密公钥及密码盐值1（web端）
|
||||
|
||||
> http://passport.bilibili.com/login?act=getkey
|
||||
|
||||
*请求方式：GET*
|
||||
|
||||
**json回复：**
|
||||
|
||||
根对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | ------------ | ---------------- |
|
||||
| hash | str | 密码校验盐值 | 有效时间为20s |
|
||||
| key | str | RSA公钥 | **公钥为固定值** |
|
||||
|
||||
**示例：**
|
||||
|
||||
```shell
|
||||
curl 'http://passport.bilibili.com/login?act=getkey'
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"hash":"07c6501690c1af85",
|
||||
"key":"-----BEGIN PUBLIC KEY-----\nMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDjb4V7EidX/ym28t2ybo0U6t0n\n6p4ej8VjqKHg100va6jkNbNTrLQqMCQCAYtXMXXp2Fwkk6WR+12N9zknLjf+C9sx\n/+l48mjUU8RqahiFD1XT/u2e0m2EN029OhCgkHx3Fc/KlFSIbak93EH/XlYis0w+\nXl69GV6klzgxW6d2xQIDAQAB\n-----END PUBLIC KEY-----\n"
|
||||
}
|
||||
```
|
||||
|
||||
## 获取加密公钥及密码盐值2（APP端）
|
||||
|
||||
> http://passport.bilibili.com/api/oauth2/getKey
|
||||
|
||||
*请求方式：POST*
|
||||
|
||||
**正文参数（ application/x-www-form-urlencoded ）：**
|
||||
|
||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||
| ------ | ---- | ------- | ----------- | ---- |
|
||||
| appkey | str | APP密钥 | APP方式必要 | |
|
||||
| sign | str | APP签名 | APP方式必要 | |
|
||||
|
||||
**json回复：**
|
||||
|
||||
根对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ---- | ---- | ------------ | ---------------- |
|
||||
| hash | str | 验证hash盐值 | 有效时间为20s |
|
||||
| key | str | RSA公钥 | **公钥为固定值** |
|
||||
|
||||
**示例：**
|
||||
|
||||
```shell
|
||||
curl 'http://passport.bilibili.com/api/oauth2/getKey'\
|
||||
--data-urlencode 'appkey=1d8b6e7d45233436'\
|
||||
--data-urlencode 'sign=17004c193f688f0b5665c1068e733aff'
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"hash":"07c6501690c1af85",
|
||||
"key":"-----BEGIN PUBLIC KEY-----\nMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDjb4V7EidX/ym28t2ybo0U6t0n\n6p4ej8VjqKHg100va6jkNbNTrLQqMCQCAYtXMXXp2Fwkk6WR+12N9zknLjf+C9sx\n/+l48mjUU8RqahiFD1XT/u2e0m2EN029OhCgkHx3Fc/KlFSIbak93EH/XlYis0w+\nXl69GV6klzgxW6d2xQIDAQAB\n-----END PUBLIC KEY-----\n"
|
||||
}
|
||||
```
|
||||
|
||||
## 登录密码的加密
|
||||
|
||||
**注：RSA公钥一般为固定值**
|
||||
|
||||
```
|
||||
-----BEGIN PUBLIC KEY-----
|
||||
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDjb4V7EidX/ym28t2ybo0U6t0n
|
||||
6p4ej8VjqKHg100va6jkNbNTrLQqMCQCAYtXMXXp2Fwkk6WR+12N9zknLjf+C9sx
|
||||
/+l48mjUU8RqahiFD1XT/u2e0m2EN029OhCgkHx3Fc/KlFSIbak93EH/XlYis0w+
|
||||
Xl69GV6klzgxW6d2xQIDAQAB
|
||||
-----END PUBLIC KEY-----
|
||||
```
|
||||
|
||||
例如登录密码为：
|
||||
|
||||
```
|
||||
BiShi22332323
|
||||
```
|
||||
|
||||
获取到的盐值为：
|
||||
|
||||
```
|
||||
8e0db05c46f4052c
|
||||
```
|
||||
|
||||
那么按照`盐值`+`密码字串`连接二者得到：
|
||||
|
||||
```
|
||||
8e0db05c46f4052cBiShi22332323
|
||||
```
|
||||
|
||||
用公钥进行RSA加密得到base64字串：
|
||||
|
||||
因为公钥的**无法解密性**和盐值的**超时机制**，故无法本地验证加密结果
|
||||
|
||||
```
|
||||
YgpjxAQ22pKa9socHIKPCZX0a/NS6Ng9Zzy+rp16b0LJGT6RHw2ERs3+ijCpG96PKTY1Baavwf0xgotmNvpl25l1KO5y4AjcqeWTzNTSVn6ejonBXGmBMybHHYawJ0aMPn1eDGpKrbI91mrF+h2x+fsnnpuZ1gheiYGzFmtshUc=
|
||||
```
|
||||
|
||||
## 使用账号密码登录（web端）
|
||||
|
||||
> http://passport.bilibili.com/web/login/v2
|
||||
|
||||
*请求方式：POST*
|
||||
|
||||
验证登录成功后会进行设置以下cookie项：
|
||||
|
||||
`sid` `DedeUserID` `DedeUserID__ckMd5` `SESSDATA` `bili_jct`
|
||||
|
||||
**正文参数（ application/x-www-form-urlencoded ）：**
|
||||
|
||||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||||
| ----------- | ---- | ------------------ | ------ | ---------------- |
|
||||
| captchaType | num | 6 | 必要 | 必须为`6` |
|
||||
| username | str | 用户登录账号 | 必要 | 手机号或邮箱地址 |
|
||||
| password | str | 加密后的带盐密码 | 必要 | base64格式 |
|
||||
| keep | bool | true | 必要 | 必须为`true` |
|
||||
| key | str | 登录秘钥 | 必要 | 从B站API获取 |
|
||||
| challenge | str | 极验challenge | 必要 | 从B站API获取 |
|
||||
| validate | str | 极验结果 | 必要 | 从极验获取 |
|
||||
| seccode | str | 极验结果+`|jordan` | 必要 | 从极验获取 |
|
||||
|
||||
**json回复：**
|
||||
|
||||
根对象：
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ------- | ---- | ---------- | ------------------------------------------------------------ |
|
||||
| code | num | 返回值 | 0：成功<br />-400：请求错误<br />-629：账号或密码错误<br />-653：用户名或密码不能为空<br />-662：提交超时,请重新提交<br />-2001：缺少必要的的参数<br />2400：登录秘钥错误<br />2406：验证极验服务出错 |
|
||||
| ts | num | 当前时间戳 | 成功时无此项 |
|
||||
| message | str | 错误信息 | 默认为0 |
|
||||
| data | obj | 数据本体 | 成功时有此项 |
|
||||
|
||||
`data`对象：
|
||||
|
||||
**未登录时：**
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ----------- | ---- | ------------------- | ---- |
|
||||
| redirectUrl | str | 游戏分站跨域登录url | |
|
||||
|
||||
**已登录时：**
|
||||
|
||||
| 字段 | 类型 | 内容 | 备注 |
|
||||
| ------- | ---- | ------------------------ | ---- |
|
||||
| isLogin | bool | true | |
|
||||
| goUrl | str | https://www.bilibili.com | |
|
||||
|
||||
**示例：**
|
||||
|
||||
例如用户账号为`12345678900`，加密后的密码为`xxx`，登录秘钥为`aabbccdd`，极验challenge为`2333`，极验结果为`666666`，进行验证登录操作
|
||||
|
||||
```shell
|
||||
curl 'https://passport.bilibili.com/web/login/v2'\
|
||||
--data-urlencode 'captchaType=6'\
|
||||
--data-urlencode 'username=12345678900'\
|
||||
--data-urlencode 'password=xxx'\
|
||||
--data-urlencode 'keep=true'\
|
||||
--data-urlencode 'key=aabbccdd'\
|
||||
--data-urlencode 'challenge=2333'\
|
||||
--data-urlencode 'validate=666666'\
|
||||
--data-urlencode 'seccode=666666|jordan'
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"data": {
|
||||
"redirectUrl": "https://passport.biligame.com/crossDomain?DedeUserID=***&DedeUserID__ckMd5=***&Expires=15551000&SESSDATA=***&bili_jct=***&gourl=https%3A%2F%2Fwww.bilibili.com"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**响应头部抓包信息：**
|
||||
|
||||
可明显看见设置了几个cookie（填入浏览器即可成功登录）
|
||||
|
||||
```http
|
||||
HTTP/1.1 200 OK
|
||||
Date: Mon, 13 Jul 2020 06:56:00 GMT
|
||||
Content-Type: application/json;charset=UTF-8
|
||||
Content-Length: 273
|
||||
Connection: keep-alive
|
||||
Server: Apache-Coyote/1.1
|
||||
Set-Cookie: DedeUserID=***; Domain=.bilibili.com; Expires=Sat, 09-Jan-2021 06:39:43 GMT; Path=/
|
||||
Set-Cookie: DedeUserID__ckMd5=***; Domain=.bilibili.com; Expires=Sat, 09-Jan-2021 06:39:43 GMT; Path=/
|
||||
Set-Cookie: SESSDATA=***; Domain=.bilibili.com; Expires=Sat, 09-Jan-2021 06:39:43 GMT; Path=/; HttpOnly
|
||||
Set-Cookie: bili_jct=***; Domain=.bilibili.com; Expires=Sat, 09-Jan-2021 06:39:43 GMT; Path=/
|
||||
Content-Security-Policy-Report-Only: default-src 'self' data: *.bilibili.com *.hdslb.com; style-src 'self' 'unsafe-inline' *.hdslb.com static.geetest.com; img-src 'self' data: blob: *.bilibili.com *.hdslb.com http://*.hdslb.com static.geetest.com; script-src 'self' 'unsafe-inline' 'unsafe-eval' *.bilibili.com *.hdslb.com api.geetest.com static.geetest.com; object-src 'self' *.hdslb.com; media-src 'self' *.acgvideo.com http://*.acgvideo.com *.ksyungslb.com; connect-src 'self' data: wss://*.bilibili.com:* *.bilibili.com *.hdslb.com *.biliapi.net *.biliapi.com; frame-ancestors 'self' *.bilibili.com *.biligame.com; report-uri https://security.bilibili.com/csp_report
|
||||
Expires: Mon, 13 Jul 2020 06:55:59 GMT
|
||||
Cache-Control: no-cache
|
||||
X-Cache-Webcdn: BYPASS from jd-sxhz-dx-w-01
|
||||
```
|
||||
|
||||
**游戏分站跨域登录url：**
|
||||
|
||||
游戏分站跨域登录url与cookie的值一一对应，可用于不方便设置cookie的场合提取使用
|
||||
|
||||
https://passport.biligame.com/crossDomain?
|
||||
|
||||
DedeUserID=(登录UID)&
|
||||
|
||||
DedeUserID__ckMd5=(登录UID MD5值)&
|
||||
|
||||
Expires=(过期时间 秒)&
|
||||
|
||||
SESSDATA=(登录token)&
|
||||
|
||||
bili_jct=(csrf)&
|
||||
|
||||
gourl=(跳转网址 默认为主页)
|
||||
88
login/login_action/readme.md
Normal file
88
login/login_action/readme.md
Normal file
@@ -0,0 +1,88 @@
|
||||
# 登录操作
|
||||
|
||||
人机验证方式登录包含**账号密码登录**与手**机短信验证码登录**
|
||||
|
||||
**注：扫码登录**不需要进行**人机验证**，故**不使用**以下接口
|
||||
|
||||
## 扫码登录
|
||||
|
||||
- [扫码登录](QR.md)
|
||||
|
||||
## 验证登录
|
||||
|
||||
人机验证流程：
|
||||
|
||||
1. 请求验证码参数，得到登录密钥`key`与极验ID`gt`和极验KEY`challenge`
|
||||
2. 进行滑动or点击验证
|
||||
3. 返回验证结果`validate`与`seccode`，进行短信或密码登录
|
||||
|
||||
|
||||
### 申请验证码参数
|
||||
|
||||
> http://passport.bilibili.com/web/captcha/combine?plat=6
|
||||
|
||||
*请求方式：GET*
|
||||
|
||||
**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 | 登录秘钥 | 与人机验证无关，与登录接口有关，但与极验KEY对应 |
|
||||
|
||||
**示例：**
|
||||
|
||||
```shell
|
||||
curl 'https://passport.bilibili.com/web/captcha/combine?plat=6'
|
||||
```
|
||||
```json
|
||||
{
|
||||
"code": 0,
|
||||
"data": {
|
||||
"result": {
|
||||
"success": 1,
|
||||
"gt": "bd111e81eda1cbb9f54425aafc0908ac",
|
||||
"challenge": "2903a8eb967a1d990444cb23ea42f417",
|
||||
"key": "76fb59fbd83a4d9d816162c5156fc964"
|
||||
},
|
||||
"type": 1
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
### 进行验证
|
||||
|
||||
本文档为Bilibili文档，验证码为geetest极验提供，故不提供api
|
||||
|
||||
附: [手动验证器](https://kuresaru.github.io/geetest-validator/)
|
||||
[及其源码](https://github.com/kuresaru/geetest-validator)
|
||||
|
||||
1. 打开手动验证器，在1、2分别填入上面API返回的`gt`和`challenge`
|
||||
2. 点击按钮3，稍等加载验证码，点击按钮4进行验证
|
||||
3. 验证完成后，点击按钮5生成验证结果
|
||||
4. 使用最开始获得到的`key`、`challenge`和刚获得到的`validate`、`seccode`继续之后的登录操作
|
||||
|
||||
|
||||
### 继续登录
|
||||
|
||||
- [短信登录](SMS.md)
|
||||
- [密码登录](password.md)
|
||||
Reference in New Issue
Block a user