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