> For the complete documentation index, see [llms.txt](https://docs.wjlo.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wjlo.cc/open/openoalogin.md).

# OA第三方登录

使用本接口可以将本站的用户信息接入您的应用中，实现数据共享。

[点击这里](https://open.wjlnb.com/oalogin/reg) 申请该项目的appid

[点击这里](https://demo.wjlnb.com/open/oa/) 体验该项目的demo

登录发起URL：

```
https://open.wjlnb.com/oalogin/1.0/auth
```

应有参数：

| 参数    | 说明          |
| ----- | ----------- |
| appid | 开放平台应用appid |

示例URL：

```
https://open.wjlnb.com/oalogin/1.0/auth?appid=demo
```

在显示页面中可进行登录操作，认证通过后将携带 oacode 被重定向至回调地址

正常回调的话，回调地址url内应如下图所示

其中，code后就是oacode，是您向服务器发起验证的凭证

```
http://callbackurl?code=6d5a8408-0ee3-7337-9df1-f80699c45547
```

回调地址在获取到oacode后应与服务器验证

请求URL

```
https://open.wjlnb.com/oalogin/1.0/get
```

请求参数：

| 参数        | 说明              |
| --------- | --------------- |
| appid     | 开放平台应用appid     |
| appsecret | 开放平台应用appsecret |
| code      | 系统给予回调地址的oacode |

验证通过后将会返回json格式的信息

基本登录回调内容：

| 参数     | 说明     |
| ------ | ------ |
| status | 提示请求状态 |
| oaname | 用户名    |
| oaavr  | 用户头像地址 |
| oaid   | 用户uid  |

{

"status":"ok",

"oaname":"adminwjl",

"oaavr":"https:\\/\\/avatar.wjlcdn.com\\/u\\/1\\/a1626766507.jpeg",

"oaid":"1"

}

**常见错误代码：**

| 环节   | **所属参数** | 错误提示               | 说明                |
| ---- | -------- | ------------------ | ----------------- |
| 发起登录 | -        | 弹出窗口：该应用不存在        | 找不到匹配的appid       |
| 回调   | status   | error:timeout      | oacode过期了，应重新发起登录 |
| 回调   | status   | error:codenotfound | 数据库中找不到匹配的oacode  |