180 lines
6.0 KiB
Markdown
180 lines
6.0 KiB
Markdown
# v_voucher 验证
|
||
|
||
## 简述
|
||
|
||
当同一接口在短时间内被同一用户/IP/UA多次请求或异常时, 会触发风控, 如接口返回 `code` 为 `-352` 即 `风控校验失败`, 同时 `data` 中出现 `v_voucher` 字段, 响应头出现 `x-bili-gaia-vvoucher`
|
||
|
||
`v_voucher` 结构为字符串 `voucher_` 尾随一串以 `-` 为分隔符的小写 UUID
|
||
|
||
`v_voucher` 可用于申请 captcha 验证码, 若无意外发生, 根据验证结果使用 `validate` 接口获取 `grisk_id` 作为被风控接口的 `gaia_vtoken` 与 Cookie 中的 `x-bili-gaia-vtoken`, 即可恢复正常访问
|
||
|
||
若该情况出现在使用 Wbi 签名的接口中, 建议先检查 Wbi 签名是否正确. 若已检查 Wbi 签名或无需签名, 检查请求头中 `User-Agent` `Referer` 是否正常, 以及 `Cookie` 中 [`bili_ticket`](bili_ticket.md) [`b_nut` `buvid3` `buvid4`](../buvid3_4.md) 等是否存在. 使用 captcha 是最后的选择, 因为 captcha 验证需要用户操作<!--, 且这几天做验证码做的真的要疯了喵-->
|
||
|
||
参见 [#1067](https://github.com/SocialSisterYi/bilibili-API-collect/issues/1067)
|
||
|
||
**注意: 不是所有风控都可以使用本方式通过 captcha 解决**
|
||
|
||
## 操作流程
|
||
|
||
1. 快速以不正确的姿势请求接口, 直到返回 `v_voucher` 字段如下. 若 `data` 中没有 `v_voucher` 字段, 则检查响应头 `x-bili-gaia-vvoucher`
|
||
|
||
```json
|
||
{
|
||
"code": -352,
|
||
"message": "风控校验失败",
|
||
"ttl": 1,
|
||
"data": {
|
||
"v_voucher": "voucher_84a8c3ce-33f5-4551-9552-9c6b13aa7938"
|
||
}
|
||
}
|
||
```
|
||
|
||
2. [请求 `register` 接口](#从-v_voucher-申请-captcha), 请求体传入 `csrf` 及 `v_voucher`, 该接口返回与 [申请captcha验证码](../../login/login_action/readme.md#申请captcha验证码) 部分相同, 记录此处返回的 `token` `challenge`
|
||
|
||
3. 按照 [验证captcha验证码](../../login/login_action/readme.md#验证captcha验证码) 进行验证, 记下验证结果的 `validate` 与 `seccode`
|
||
|
||
4. [请求 `validate` 接口](#从验证结果获取-grisk_id), 请求体传入 `challenge` `token` `validate` `seccode` `csrf`, 该接口返回 `grisk_id` 即 `gaia_vtoken` 与 `x-bili-gaia-vtoken`
|
||
|
||
5. 重新请求原接口, 原 URL 参数加入 `gaia_vtoken`, Cookie 加入 `x-bili-gaia-vtoken`, 即恢复正常
|
||
|
||
## 接口列表
|
||
|
||
### 从 v_voucher 申请 captcha
|
||
|
||
> https://api.bilibili.com/x/gaia-vgate/v1/register
|
||
|
||
注: 同一有效 `v_voucher` 只能请求一次, 请求完毕请立即 [进行验证](../../login/login_action/readme.md#进行验证) 防止过期失效
|
||
|
||
*请求方式: POST*
|
||
|
||
**正文参数(application/x-www-form-urlencoded):**
|
||
|
||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||
| ------ | ---- | ------- | ------ | ---- |
|
||
| csrf | str | CSRF Token (位于 Cookie 的 bili_jct) | 非必要 | |
|
||
| v_voucher | str | v_voucher | 必要 | |
|
||
|
||
**JSON回复:**
|
||
|
||
根对象:
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----- | ---- | ------ | ---- |
|
||
| code | num | 返回值 | 0：成功<br />100000: 验证码获取失败 |
|
||
| message | str | 错误信息 | 默认为 0 |
|
||
| ttl | num | 1 | |
|
||
| data | obj | 信息本体 | |
|
||
|
||
`data` 对象:
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----- | ---- | ------ | ---- |
|
||
| type | str | 验证码类型 | 目前只有 `geetest` |
|
||
| token | str | 验证码 token | 用于验证 |
|
||
| geetest | obj | 极验信息 | 若为 null 则说明该风控无法通过 captcha 解除 |
|
||
| biliword | null | | |
|
||
| phone | null | | |
|
||
| sms | null | | |
|
||
|
||
`geetest` 对象:
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| -------- | ----- | ------ | -------- |
|
||
| gt | str | 极验id | 一般为固定值 |
|
||
| challenge | str | 极验KEY | 由B站后端产生用于人机验证 |
|
||
|
||
**示例:**
|
||
|
||
假设此处 `v_voucher` 为 `voucher_ecca35e6-36da-4f38-bd84-b3f420ea08c1`
|
||
|
||
```shell
|
||
curl -X POST "https://api.bilibili.com/x/gaia-vgate/v1/register" \
|
||
--data-urlencode "v_voucher=voucher_ecca35e6-36da-4f38-bd84-b3f420ea08c1"
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例:</summary>
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"message": "0",
|
||
"ttl": 1,
|
||
"data": {
|
||
"type": "geetest",
|
||
"token": "e7abdb050c3d4609979f1685137e3bc0",
|
||
"geetest": {
|
||
"challenge": "85118f8714875ca4c6d5641bb0ce9ddf",
|
||
"gt": "ac597a4506fee079629df5d8b66dd4fe"
|
||
},
|
||
"biliword": null,
|
||
"phone": null,
|
||
"sms": null
|
||
}
|
||
}
|
||
```
|
||
|
||
</details>
|
||
|
||
## 从验证结果获取 grisk_id
|
||
|
||
> https://api.bilibili.com/x/gaia-vgate/v1/validate
|
||
|
||
*请求方式: POST*
|
||
|
||
**正文参数(application/x-www-form-urlencoded):**
|
||
|
||
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|
||
| ------ | ---- | ------ | ---- | ---- |
|
||
| csrf | str | CSRF Token (位于 Cookie 的 bili_jct) | 非必要 | 若登陆则必要 |
|
||
| challenge | str | 验证码 challenge | 必要 | |
|
||
| token | str | 验证码 token | 必要 | |
|
||
| validate | str | 验证结果 validate | 必要 | |
|
||
| seccode | str | 验证结果 seccode | 必要 | |
|
||
|
||
**JSON回复:**
|
||
|
||
根对象:
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----- | ---- | ------ | ---- |
|
||
| code | num | 返回值 | 0：成功<br />-111: csrf 校验失败<br />100003: 验证码过期 |
|
||
| message | str | 错误信息 | 默认为 0 |
|
||
| ttl | num | 1 | |
|
||
| data | obj | 信息本体 | |
|
||
|
||
`data` 对象:
|
||
|
||
| 字段 | 类型 | 内容 | 备注 |
|
||
| ----- | ---- | ------ | ---- |
|
||
| is_valid | num | 验证结果 | 1：验证成功 |
|
||
| grisk_id | str | gaia_vtoken | 用于恢复正常访问 |
|
||
|
||
**示例:**
|
||
|
||
```shell
|
||
curl -X POST "https://api.bilibili.com/x/gaia-vgate/v1/validate" \
|
||
--data-urlencode "challenge=e4fcb337b8c0427b56320f97e1064210" \
|
||
--data-urlencode "csrf=xxxxxxxxxxxxxxx" \
|
||
--data-urlencode "seccode=360f7b9cf75c74c68fbb7475416d0e0d|jordan" \
|
||
--data-urlencode "token=0e1e58bdff3d4b8aa298e346fed07eeb" \
|
||
--data-urlencode "validate=360f7b9cf75c74c68fbb7475416d0e0d"
|
||
```
|
||
|
||
<details>
|
||
<summary>查看响应示例:</summary>
|
||
|
||
```json
|
||
{
|
||
"code": 0,
|
||
"message": "0",
|
||
"ttl": 1,
|
||
"data": {
|
||
"is_valid": 1,
|
||
"grisk_id": "2e91cf2b67172ca8432fe7c9ab66a5c4"
|
||
}
|
||
}
|
||
```
|
||
|
||
</details>
|