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编码)

img.png


1.5. 响应参数示例

{
    "data" : "DE5608B991EA6F56F4C7812D75242425",
    "code" :  "100",
    "msg" : "获取token成功",
    "success" : true
}

1.6. 异常响应说明

code编码 字段说明
110005 合作伙伴不存在
110006 安全码错误
110007 合作伙伴未启用
110008 合作伙伴不是教务处

Copyright © 5idream.net 2018 all right reserved该文件修订时间: 2024-11-05 17:58:45

results matching ""

    No results matching ""