#### 简要描述:
- **授权码模式开发中**
- 获取授权码**页面**
- 第三方平台进行授权登录时,跳转到懂你教育开放平台获取授权码页面,用户通过验证授权之后,懂你教育开发平台会跳转到制定的回调地址
- 前置参数:
参数名|类型|示例值|说明
:---- |:---|:----- |-----
client_id |string | dongni | 懂你教育开放平台提供的应用id
client_secret |string | dongni100 | 懂你教育开发平台提供的应用id对应的密码
#### 接口版本:
|版本号|制定人|修订日期|
|:---:|:---:|:---:|
| 1.0.0 | sapluk | 2019-06-27 |
| 1.0.1 | sapluk | 2019-09-18 |
#### 请求URL:
- (开发中)https://open.dongni100.com/auth/oauth/authorize
- 这是一个页面,由懂你教育开放平台维护,负责用户的登录行为,用户成功授权后会跳转到第三方应用提供的回调网址
#### 请求方式:
- GET
#### 请求头:
- 无
#### 请求参数:
|参数名 | 是否必需 | 类型 | 示例值 | 说明
|:---- |:---:|:----- |----- |----- |
|client_id | 是 | string | dongni100 | 客户端id。由懂你教育分配给应用
|response_type | 是 | string | code | 授权类型。由懂你教育分配给应用。仅支持授权码模式,"code",
|scope | 是 | string | read | 权限范围。由懂你教育分配给应用。目前仅支持"read"
|redirect_uri | 是 | string | http%3A%2F%2F127.0.0.1%3A23456%2 | 回调网址,url编码。<br/>由应用提供给懂你教育开放平台进行登记后可使用 <br/>用户授权后会跳转到该uri,并携带code/state信息。
|state | 是 | string | EJdsT | state参数,用于保持请求和回调的状态。使用随机字符串,该参数重定向时会原样返回。<br/>开发者可以用这个参数验证请求有效性,也可以记录用户请求授权页前的位置。这个参数可用于防止跨站请求伪造(CSRF)攻击。
#### 返回示例:
**正确时返回:**
```
HTTP/1.1 302
Location: http://127.0.0.1:23456/user?code=RkpLxi&state=EJdsT
```
**错误时返回:**
```
错误返回包括 用户名或密码错误 / 验证码错误等,该错误由懂你教育开发平台进行处理维护
```
#### 返回参数说明:
|参数名 | 类型 | 示例值 | 说明
|:----- |:-----|----- |---
|code | String | RkpLxi | code。用于后续获取access_token,仅允许使用一次
|state | string | EJdsT | 由接口调用方提供的随机码,并原样返还
#### 备注:
- 更多返回错误代码请看首页的错误代码描述
简要描述:
- 授权码模式开发中
- 获取授权码页面
- 第三方平台进行授权登录时,跳转到懂你教育开放平台获取授权码页面,用户通过验证授权之后,懂你教育开发平台会跳转到制定的回调地址
- 前置参数:
| 参数名 |
类型 |
示例值 |
说明 |
| client_id |
string |
dongni |
懂你教育开放平台提供的应用id |
| client_secret |
string |
dongni100 |
懂你教育开发平台提供的应用id对应的密码 |
接口版本:
| 版本号 |
制定人 |
修订日期 |
| 1.0.0 |
sapluk |
2019-06-27 |
| 1.0.1 |
sapluk |
2019-09-18 |
请求URL:
请求方式:
请求头:
请求参数:
| 参数名 |
是否必需 |
类型 |
示例值 |
说明 |
| client_id |
是 |
string |
dongni100 |
客户端id。由懂你教育分配给应用 |
| response_type |
是 |
string |
code |
授权类型。由懂你教育分配给应用。仅支持授权码模式,”code”, |
| scope |
是 |
string |
read |
权限范围。由懂你教育分配给应用。目前仅支持”read” |
| redirect_uri |
是 |
string |
http%3A%2F%2F127.0.0.1%3A23456%2 |
回调网址,url编码。 由应用提供给懂你教育开放平台进行登记后可使用 用户授权后会跳转到该uri,并携带code/state信息。 |
| state |
是 |
string |
EJdsT |
state参数,用于保持请求和回调的状态。使用随机字符串,该参数重定向时会原样返回。 开发者可以用这个参数验证请求有效性,也可以记录用户请求授权页前的位置。这个参数可用于防止跨站请求伪造(CSRF)攻击。 |
返回示例:
正确时返回:
HTTP/1.1 302
Location: http://127.0.0.1:23456/user?code=RkpLxi&state=EJdsT
错误时返回:
错误返回包括 用户名或密码错误 / 验证码错误等,该错误由懂你教育开发平台进行处理维护
返回参数说明:
| 参数名 |
类型 |
示例值 |
说明 |
| code |
String |
RkpLxi |
code。用于后续获取access_token,仅允许使用一次 |
| state |
string |
EJdsT |
由接口调用方提供的随机码,并原样返还 |
备注:
作者:谢烨宇 创建时间:2019-06-27 18:06
更新时间:2022-12-20 14:39