修正错误与表格格式 (#473)

This commit is contained in:
7rikka 2022-09-13 09:45:07 +08:00 committed by GitHub
parent 15ffe4692a
commit fbd4044844
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -51,19 +51,19 @@ while True:
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0成功 |
| message | str | 错误信息 | |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|------|
| code | num | 返回值 | 0成功 |
| message | str | 错误信息 | |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ---------- | ---- | ------------------------- | ---------- |
| url | str | 二维码内容 (登录页面 url) | |
| qrcode_key | str | 扫码登录秘钥 | 恒为32字符 |
| 字段 | 类型 | 内容 | 备注 |
|------------|-----|------------------|--------|
| url | str | 二维码内容 (登录页面 url) | |
| qrcode_key | str | 扫码登录秘钥 | 恒为32字符 |
**示例:**
@ -75,6 +75,7 @@ curl 'http://passport.bilibili.com/x/passport-login/web/qrcode/generate'
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
@ -99,33 +100,33 @@ curl 'http://passport.bilibili.com/x/passport-login/web/qrcode/generate'
验证登录成功后会进行设置以下cookie项
`DedeUserID` `DedeUserID__ckMd5` `SESSDATA` `bili_jct`
`DedeUserID` `DedeUserID__ckMd5` `SESSDATA` `bili_jct`
**url参数**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| ---------- | ---- | ------------ | ------ | ---- |
| qrcode_key | str | 扫码登录秘钥 | 非必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|------------|-----|--------|-----|-----|
| qrcode_key | str | 扫码登录秘钥 | 非必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ------- |
| code | num | 返回值 | 0成功 |
| message | str | 错误信息 | |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|------|
| code | num | 返回值 | 0成功 |
| message | str | 错误信息 | |
| data | obj | 信息本体 | |
data 对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------------------------------------------------------ | ---------------------------------- |
| url | str | 游戏分站跨域登录 url | 未登录为空 |
| refresh_token | str | 刷新`refresh_token` | 未登录为空 |
| timestamp | num | 登录时间 | 未登录为`0`<br />时间戳 单位为毫秒 |
| code | num | 0扫码登录成功<br />86038二维码已失效<br />86090二维码已扫码未确认<br />86101未扫码 | |
| message | str | 扫码状态信息 | |
| 字段 | 类型 | 内容 | 备注 |
|---------------|-----|----------------------------------------------------------------|------------------------|
| url | str | 游戏分站跨域登录 url | 未登录为空 |
| refresh_token | str | 刷新`refresh_token` | 未登录为空 |
| timestamp | num | 登录时间 | 未登录为`0`<br />时间戳 单位为毫秒 |
| code | num | 0扫码登录成功<br />86038二维码已失效<br />86090二维码已扫码未确认<br />86101未扫码 | |
| message | str | 扫码状态信息 | |
**示例:**
@ -137,7 +138,7 @@ curl -G "http://passport.bilibili.com/x/passport-login/web/qrcode/poll"\
-c 'cookie.txt'
```
当密钥正确时但未扫描时`message`为`86101`
当密钥正确时但未扫描时`code`为`86101`
<details>
<summary>查看响应示例:</summary>
@ -145,27 +146,26 @@ curl -G "http://passport.bilibili.com/x/passport-login/web/qrcode/poll"\
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"url": "",
"refresh_token": "",
"timestamp": 0,
"code": 86101,
"message": "未扫码"
}
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"url": "",
"refresh_token": "",
"timestamp": 0,
"code": 86101,
"message": "未扫码"
}
}
```
</details>
扫描成功但手机端未确认时`message`为`86038`
扫描成功但手机端未确认时`code`为`86090`
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
@ -183,10 +183,11 @@ curl -G "http://passport.bilibili.com/x/passport-login/web/qrcode/poll"\
</details>
扫描成功手机端确认登录后,`message`为`0`并向浏览器写入cookie
扫描成功手机端确认登录后,`code`为`0`并向浏览器写入cookie
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
@ -210,6 +211,7 @@ curl -G "http://passport.bilibili.com/x/passport-login/web/qrcode/poll"\
<details>
<summary>查看响应示例:</summary>
```http
HTTP/1.1 200 OK
Date: Mon, 05 Sep 2022 07:30:09 GMT
@ -230,6 +232,28 @@ x-cache-webcdn: BYPASS from blzone02
</details>
二维码失效时`code`为`86038`
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"url": "",
"refresh_token": "",
"timestamp": 0,
"code": 86038,
"message": "二维码已失效"
}
}
```
</details>
## web端扫码登录-旧版
以下为旧版扫码登录 API尚可正常访问
@ -246,19 +270,19 @@ x-cache-webcdn: BYPASS from blzone02
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------ | ---- | -------- | ------------ |
| code | num | 返回值 | 0成功 |
| status | bool | true | 作用尚不明确 |
| ts | num | 请求时间 | 时间戳 |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
|--------|------|------|--------|
| code | num | 返回值 | 0成功 |
| status | bool | true | 作用尚不明确 |
| ts | num | 请求时间 | 时间戳 |
| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------------------- | ---------- |
| url | str | 二维码内容 (登录页面 url) | |
| oauthKey | str | 扫码登录秘钥 | 恒为32字符 |
| 字段 | 类型 | 内容 | 备注 |
|----------|-----|------------------|--------|
| url | str | 二维码内容 (登录页面 url) | |
| oauthKey | str | 扫码登录秘钥 | 恒为32字符 |
**示例:**
@ -270,6 +294,7 @@ curl 'http://passport.bilibili.com/qrcode/getLoginUrl'
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
@ -294,32 +319,32 @@ curl 'http://passport.bilibili.com/qrcode/getLoginUrl'
验证登录成功后会进行设置以下cookie项
`DedeUserID` `DedeUserID__ckMd5` `SESSDATA` `bili_jct`
`DedeUserID` `DedeUserID__ckMd5` `SESSDATA` `bili_jct`
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------ | ------ | ----------------------------- |
| oauthKey | str | 扫码登录秘钥 | 必要 | |
| gourl | str | 跳转url | 非必要 | 默认为http://www.bilibili.com |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|----------|-----|--------|-----|----------------------------|
| oauthKey | str | 扫码登录秘钥 | 必要 | |
| gourl | str | 跳转url | 非必要 | 默认为http://www.bilibili.com |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---------------------------- | ----------------------------------------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功 |
| message | str | | 正确无 |
| ts | num | 扫码时间 | 错误无 |
| status | bool | 扫码是否成功 | true成功<br />false未成功 |
| 字段 | 类型 | 内容 | 备注 |
|---------|----------------------|---------------------------|---------------------------------------------------------|
| code | num | 返回值 | 0成功 |
| message | str | | 正确无 |
| ts | num | 扫码时间 | 错误无 |
| status | bool | 扫码是否成功 | true成功<br />false未成功 |
| data | 正确时obj<br />错误时num | 正确时游戏分站url<br />错误时:错误代码 | 未成功时:<br />-1密钥错误<br />-2密钥超时<br />-4未扫描<br />-5未确认 |
data 对象:
| 字段 | 类型 | 内容 | 备注 |
| ---- | ---- | -------------------- | ---- |
| url | str | 游戏分站跨域登录 url | |
| 字段 | 类型 | 内容 | 备注 |
|-----|-----|--------------|-----|
| url | str | 游戏分站跨域登录 url | |
**示例:**
@ -335,6 +360,7 @@ curl "http://passport.bilibili.com/qrcode/getLoginInfo"\
<details>
<summary>查看响应示例:</summary>
```json
{
"status":false,
@ -349,6 +375,7 @@ curl "http://passport.bilibili.com/qrcode/getLoginInfo"\
<details>
<summary>查看响应示例:</summary>
```json
{
"status":false,
@ -363,6 +390,7 @@ curl "http://passport.bilibili.com/qrcode/getLoginInfo"\
<details>
<summary>查看响应示例:</summary>
```json
{
"code": 0,
@ -382,6 +410,7 @@ curl "http://passport.bilibili.com/qrcode/getLoginInfo"\
<details>
<summary>查看响应示例:</summary>
```http
HTTP/1.1 200 OK
Date: Wed, 04 Mar 2020 10:36:37 GMT
@ -417,30 +446,30 @@ X-Cache-Webcdn: BYPASS from ks-sxhz-dx-w-01
**正文参数( application/x-www-form-urlencoded **
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------- | ----------- | ------------------------ |
| appkey | str | APP密钥 | APP方式必要 | 仅可用`4409e2ce8ffd12b8` |
| local_id | str | TV端id | TV端必要 | 可为`0` |
| ts | num | 当前时间戳 | APP方式必要 | |
| sign | str | APP签名 | APP方式必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|----------|-----|-------|---------|-----------------------|
| appkey | str | APP密钥 | APP方式必要 | 仅可用`4409e2ce8ffd12b8` |
| local_id | str | TV端id | TV端必要 | 可为`0` |
| ts | num | 当前时间戳 | APP方式必要 | |
| sign | str | APP签名 | APP方式必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ---- | -------- | ---------------------------------------------------- |
| code | num | 返回值 | 0成功<br />-3API校验密匙错误<br />-400请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
|---------|-----|------|---------------------------------------|
| code | num | 返回值 | 0成功<br />-3API校验密匙错误<br />-400请求错误 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | obj | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| -------- | ---- | ------------- | ---------- |
| url | str | 二维码内容url | |
| oauthKey | str | 扫码登录秘钥 | 恒为32字符 |
| 字段 | 类型 | 内容 | 备注 |
|----------|-----|----------|--------|
| url | str | 二维码内容url | |
| oauthKey | str | 扫码登录秘钥 | 恒为32字符 |
**示例:**
@ -457,13 +486,13 @@ curl 'http://passport.snm0516.aisee.tv/x/passport-tv-login/qrcode/auth_code' \
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"url": "https://passport.snm0516.aisee.tv/x/passport-tv-login/h5/qrcode/auth?auth_code=0eeb635a64526709d70cb4c854a3b001",
"auth_code": "0eeb635a64526709d70cb4c854a3b001"
}
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"url": "https://passport.snm0516.aisee.tv/x/passport-tv-login/h5/qrcode/auth?auth_code=0eeb635a64526709d70cb4c854a3b001",
"auth_code": "0eeb635a64526709d70cb4c854a3b001"
}
}
```
@ -483,33 +512,33 @@ curl 'http://passport.snm0516.aisee.tv/x/passport-tv-login/qrcode/auth_code' \
**正文参数 (application/x-www-form-urlencoded)**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| --------- | ---- | ---------- | ----------- | ------------------------ |
| appkey | str | APP密钥 | APP方式必要 | 仅可用`4409e2ce8ffd12b8` |
| auth_code | str | 扫码秘钥 | 必要 | |
| local_id | str | TV端id | TV端必要 | 可为0 |
| ts | num | 当前时间戳 | APP方式必要 | |
| sign | str | APP签名 | APP方式必要 | |
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
|-----------|-----|-------|---------|-----------------------|
| appkey | str | APP密钥 | APP方式必要 | 仅可用`4409e2ce8ffd12b8` |
| auth_code | str | 扫码秘钥 | 必要 | |
| local_id | str | TV端id | TV端必要 | 可为0 |
| ts | num | 当前时间戳 | APP方式必要 | |
| sign | str | APP签名 | APP方式必要 | |
**json回复**
根对象:
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------------------------- | -------- | ------------------------------------------------------------ |
| code | num | 返回值 | 0成功<br />-3API校验密匙错误<br />-400请求错误<br />86038二维码已失效<br />86039二维码尚未确认 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 有效时obj<br />无效时null | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
|---------|-----------------------|------|----------------------------------------------------------------------------|
| code | num | 返回值 | 0成功<br />-3API校验密匙错误<br />-400请求错误<br />86038二维码已失效<br />86039二维码尚未确认 |
| message | str | 错误信息 | 默认为0 |
| ttl | num | 1 | |
| data | 有效时obj<br />无效时null | 信息本体 | |
`data`对象:
| 字段 | 类型 | 内容 | 备注 |
| ------------- | ---- | ------------ | -------------------- |
| mid | num | 登录用户mid | |
| access_token | str | APP登录Token | |
| refresh_token | str | APP刷新Token | |
| expires_in | num | 有效时间 | 单位为秒 一般为30天 |
| 字段 | 类型 | 内容 | 备注 |
|---------------|-----|------------|--------------|
| mid | num | 登录用户mid | |
| access_token | str | APP登录Token | |
| refresh_token | str | APP刷新Token | |
| expires_in | num | 有效时间 | 单位为秒 一般为30天 |
**示例:**
@ -529,15 +558,15 @@ curl 'http://passport.snm0516.aisee.tv/x/passport-tv-login/qrcode/poll' \
```json
{
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 293793435,
"access_token": "***",
"refresh_token": "***",
"expires_in": 2592000
}
"code": 0,
"message": "0",
"ttl": 1,
"data": {
"mid": 293793435,
"access_token": "***",
"refresh_token": "***",
"expires_in": 2592000
}
}
```