---
order: 10
navTitle: 注销
---
# 注销

用于子系统需要注销登录且希望和主系统一起注销（比如想注销后切换另外一个身份登录）。

1. 访问此URL会注销主系统
2. 主系统注销后，会重定向给子系统，通知子系统注销

## 调用方式

请求方式：`GET`\
请求url：`/api/oauth2/logout`

url参数说明：

| 参数         | 必须 | 说明                                                                                                                                               |
| :----------- | :--- | :------------------------------------------------------------------------------------------------------------------------------------------------- |
| redirect\_uri | 是   | 注销成功后回调地址，此url应该是能让子系统也注销，需要与应用所配置域名在同一个域中，需要进行[URL转义](https://tool.chinaz.com/tools/urlencode.aspx) |
| appid        | 是   | 应用ID                                                                                                                                             |
| state        | 否   | 状态码，传递一个随机数即可，用来防止CRSF攻击                                                                                                       |

示例：

```bash
http://example.bi.com/api/oauth2/logout?redirect_uri=http%3A%2F%2Fexample.com%2Fxm%2Flogout&appid=xxxx&state=xrtcyubi
```

## 返回值说明

此api无返回值，当主系统注销成功后，会重定向到`redirect_uri`，通知子系统注销。