Northern_Lights/bilibili-API-collect
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

补充退出登录接口请求细节 (#474)

Browse Source 
* 补充退出登录接口请求细节

* fix format

Co-authored-by: 社会易姐QwQ <45892418+SocialSisterYi@users.noreply.github.com>
This commit is contained in:
7rikka 2022-09-13 15:28:17 +08:00 committed by GitHub
parent c8649079dd
commit 671ceb7b44
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 29 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
login/exit.md
View File

@ -1,11 +1,10 @@
# 退出账号登录
- [退出账号登录](#退出账号登录)
- [退出登录（web 端）](#退出登录web-端)
- [退出登录(web 端)](#退出登录(web端))
---
## 退出登录（web 端）
## 退出登录(web端)
> http://passport.bilibili.com/login/exit/v2
@ -13,43 +12,48 @@ _请求方式：POST_
认证方式：Cookie
验证登录成功后会进行删除以下 cookie 项：
验证登录成功后会使用`set-cookie`字段清空以下 cookie 项：
`DedeUserID` `DedeUserID__ckMd5` `SESSDATA` `bili_jct`
并在服务器注销该登录 Token（SESSDATA），该 Token 即失效
并在服务器注销该登录 Token (SESSDATA)，该 Token 即失效
**正文参数（ application/x-www-form-urlencoded ）：**
请求必须包含以下cookie项：`DedeUserID` `bili_jct` `SESSDATA`
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ------------------------- | --------------- | ---------------------------------- |
| biliCSRF | str | CSRF Token（位于 cookie） | Cookie 方式必要 | |
| gourl | str | 成功后跳转到的页面 | 非必要 | 默认为 `javascript:history.go(-1)` |
**正文参数 (application/x-www-form-urlencoded)：**
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
| -------- | ---- | ---------------------------------------- | ------ | --------------------------------- |
| biliCSRF | str | CSRF Token (位于 cookie 中的 `bili_jct`) | 必要 | |
| gourl | str | 成功后跳转到的页面 | 非必要 | 默认为`javascript:history.go(-1)` |
**json 回复：**
如果 cookie 已经失效则返回登录页面的 html 代码
如果 cookie 已经失效则输出登录页 html
根对象：
| 字段 | 类型 | 内容 | 备注 |
| ------- | ------------------------------- | -------- | ---------------------------------- |
| code | num | 返回值 | 0：成功 <br />-2202：csrf 请求非法 |
| status | num/不存在 | 返回值 | true：成功，失败时可能不存在 |
| ts | num | 返回值 | 时间戳（例如：1631796826） |
| message | str<br />无效时：不存在 | 错误信息 | |
| data | 有效时：obj<br />无效时：不存在 | 信息本体 | |
| 字段 | 类型 | 内容 | 备注 |
| ------- | ----------- | -------- | --------------------------------- |
| code | num | 返回值 | 0：成功 <br />2202：csrf 请求非法 |
| status | bool | 返回值 | `true`：成功 |
| ts | num | 时间戳 | |
| message | str | 错误信息 | 成功时不存在 |
| data | 有效时：obj | 信息本体 | 失败时不存在 |
`data`对象：
redirectUrl 重定向 url
| 字段 | 类型 | 内容 | 备注 |
| ----------- | ---- | ---------- | ---- |
| redirectUrl | str | 重定向 url | |
**示例：**
```shell
curl -X POST https://passport.bilibili.com/login/exit/v2 \
-b "cookie字符串" \
-d "biliCSRF=xxxxxx&gourl=https://www.bilibili.com"
curl -L -X POST 'https://passport.bilibili.com/login/exit/v2' \
-H 'Cookie: DedeUserID=xxx; bili_jct=xxx; SESSDATA=xxx' \
-H 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'biliCSRF=xxxxxx'
```
<details>
@ -59,11 +63,10 @@ curl -X POST https://passport.bilibili.com/login/exit/v2 \
{
"code": 0,
"status": true,
"ts": 1631796826,
"ts": 1663034005,
"data": {
"redirectUrl": "https://passport.biligame.com/crossDomain?DedeUserID=&DedeUserID__ckMd5=&SESSDATA=&bili_jct=&gourl=https%3A%2F%2Fwww.bilibili.com"
"redirectUrl": "https://passport.biligame.com/crossDomain?DedeUserID=&DedeUserID__ckMd5=&SESSDATA=&bili_jct=&gourl=javascript%3Ahistory.go%28-1%29"
}
}
```
</details>
</details>