1. 获取token接口
1.1. 协议
- REST-URL:
open/token/oauth
- REST-HTTP-Method:
POST
- COUTENT-TYPE:
application/x-www-form-urlencoded; charset=UTF-8
1.2. 请求参数
字段名称 |
类型 |
长度 |
是否必填 |
字段说明 |
openId |
String |
50 |
YES |
到梦空间发放给合作方的ID,请勿泄露 |
key |
String |
50 |
YES |
由到梦空间发放给合作方的安全码,请勿泄露,需使用AES加密 |
1.3. 响应参数
字段名称 |
类型 |
字段说明 |
data |
String |
Token,有效期15分钟 |
success |
Boolean |
请求处理结果状态 |
msg |
String |
接口调用结果提示信息 |
code |
String |
状态码 |
1.4. 请求参数示例
将到梦提供的安全码(key)和时间戳(timestamp,格式为yyyy-MM-dd HH:mm:ss,只允许时间误差在5分钟之内的请求访问。)拼接成JSON格式,使用AES加密(AES128加密模式:CBC,填充模式:PKCS5Padding,秘钥、iv偏移量),再用Base64编码,得到密文key参数。
例如:安全码(key)为:B9E6FC410F6523E5EB9C7A72,当前时间戳为:2024-07-30 12:34:56 ,生成待加密字符串为:{"key":"B9E6FC410F6523E5EB9C7A72","timestamp":"2023-03-20 12:34:56"},使用AES加密之后,再用Base64编码(得到oW8n2aq9yJgbPq/72rYLrvp1e3HkKjobc1e1a4JoQfTM/pVDGhr9LWvWDPGOOozKfanCR0J179T9ujO7E271RJErjreKR/Jnig9merNhT+s=),作为key参数提交到接口。(注:因为存在特殊字符,代码中需要使用URL编码,有的工具默认会URL编码,请勿编码俩次,如postman工具中不需要URL编码)

1.5. 响应参数示例
{
"data" : "DE5608B991EA6F56F4C7812D75242425",
"code" : "100",
"msg" : "获取token成功",
"success" : true
}
1.6. 异常响应说明
code编码 |
字段说明 |
110005 |
合作伙伴不存在 |
110006 |
安全码错误 |
110007 |
合作伙伴未启用 |
110008 |
合作伙伴不是教务处 |