返回提交历史
Modified
login/exit.md
+29
-26
XFEstudio/bilibili-API-collect
补充退出登录接口请求细节 (#474)
* 补充退出登录接口请求细节 * fix format Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
671ceb7
代码差异
1 个文件
+29
-26
@@ -1,11 +1,10 @@
1
1
# 退出账号登录
2
2
3
- [退出账号登录](#退出账号登录)
4
- [退出登录（web 端）](#退出登录web-端)
3
- [退出登录(web 端)](#退出登录(web端))
5
4
6
5
---
7
6
8
## 退出登录（web 端）
7
## 退出登录(web端)
9
8
10
9
> http://passport.bilibili.com/login/exit/v2
11
10
@@ -13,43 +12,48 @@ _请求方式：POST_
13
12
14
13
认证方式：Cookie
15
14
16
验证登录成功后会进行删除以下 cookie 项：
15
验证登录成功后会使用`set-cookie`字段清空以下 cookie 项：
17
16
18
17
`DedeUserID` `DedeUserID__ckMd5` `SESSDATA` `bili_jct`
19
18
20
并在服务器注销该登录 Token（SESSDATA），该 Token 即失效
19
并在服务器注销该登录 Token (SESSDATA)，该 Token 即失效
21
20
22
**正文参数（ application/x-www-form-urlencoded ）：**
21
请求必须包含以下cookie项：`DedeUserID` `bili_jct` `SESSDATA`
23
22
24
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
25
| -------- | ---- | ------------------------- | --------------- | ---------------------------------- |
26
| biliCSRF | str | CSRF Token（位于 cookie） | Cookie 方式必要 | |
27
| gourl | str | 成功后跳转到的页面 | 非必要 | 默认为 `javascript:history.go(-1)` |
23
**正文参数 (application/x-www-form-urlencoded)：**
24
25
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
26
| -------- | ---- | ---------------------------------------- | ------ | --------------------------------- |
27
| biliCSRF | str | CSRF Token (位于 cookie 中的 `bili_jct`) | 必要 | |
28
| gourl | str | 成功后跳转到的页面 | 非必要 | 默认为`javascript:history.go(-1)` |
28
29
29
30
**json 回复：**
30
31
31
如果 cookie 已经失效则返回登录页面的 html 代码
32
如果 cookie 已经失效则输出登录页 html
32
33
33
34
根对象：
34
35
35
| 字段 | 类型 | 内容 | 备注 |
36
| ------- | ------------------------------- | -------- | ---------------------------------- |
37
| code | num | 返回值 | 0：成功 <br />-2202：csrf 请求非法 |
38
| status | num/不存在 | 返回值 | true：成功，失败时可能不存在 |
39
| ts | num | 返回值 | 时间戳（例如：1631796826） |
40
| message | str<br />无效时：不存在 | 错误信息 | |
41
| data | 有效时：obj<br />无效时：不存在 | 信息本体 | |
36
| 字段 | 类型 | 内容 | 备注 |
37
| ------- | ----------- | -------- | --------------------------------- |
38
| code | num | 返回值 | 0：成功 <br />2202：csrf 请求非法 |
39
| status | bool | 返回值 | `true`：成功 |
40
| ts | num | 时间戳 | |
41
| message | str | 错误信息 | 成功时不存在 |
42
| data | 有效时：obj | 信息本体 | 失败时不存在 |
42
43
43
44
`data`对象：
44
45
45
redirectUrl 重定向 url
46
| 字段 | 类型 | 内容 | 备注 |
47
| ----------- | ---- | ---------- | ---- |
48
| redirectUrl | str | 重定向 url | |
46
49
47
50
**示例：**
48
51
49
52
```shell
50
curl -X POST https://passport.bilibili.com/login/exit/v2 \
51
-b "cookie字符串" \
52
-d "biliCSRF=xxxxxx&gourl=https://www.bilibili.com"
53
curl -L -X POST 'https://passport.bilibili.com/login/exit/v2' \
54
-H 'Cookie: DedeUserID=xxx; bili_jct=xxx; SESSDATA=xxx' \
55
-H 'Content-Type: application/x-www-form-urlencoded' \
56
--data-urlencode 'biliCSRF=xxxxxx'
53
57
```
54
58
55
59
<details>
@@ -59,11 +63,10 @@ curl -X POST https://passport.bilibili.com/login/exit/v2 \
59
63
{
60
64
"code": 0,
61
65
"status": true,
62
"ts": 1631796826,
66
"ts": 1663034005,
63
67
"data": {
64
"redirectUrl": "https://passport.biligame.com/crossDomain?DedeUserID=&DedeUserID__ckMd5=&SESSDATA=&bili_jct=&gourl=https%3A%2F%2Fwww.bilibili.com"
68
"redirectUrl": "https://passport.biligame.com/crossDomain?DedeUserID=&DedeUserID__ckMd5=&SESSDATA=&bili_jct=&gourl=javascript%3Ahistory.go%28-1%29"
65
69
}
66
70
}
67
71
```
68
69
</details>
72
</details>