1. 中国大学MOOC开放接口
1.1. 通用信息
密钥信息 第三方系统平台在首次激活后，会获取以下几个参数（如）
| 参数 | 描述 |
|---|---|
| appSecret | 平台颁发给第三方系统的密钥 |
| appId | 平台颁发给第三方系统的应用id，每个应用的id都是唯一的 |
| aesKey | 用于请求中的消息体的对称加密，首次注册/登录需要对用户数据进行对称加密 |
请求参数
| 字段 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| appId | String | 是 | 平台颁发给第三方系统的应用id |
| nonce | Long | 是 | 随机数（数字开头不能为0） |
| timestamp | String | 是 | 时间戳 |
| signature | Integer | 是 | 签名，将(appSecret+nonce+timestamp)三个参数拼接的字符串，进行SHA1哈希计算 |
响应码
| code | 说明 |
|---|---|
| 200 | 正常返回 |
| 1000 | 缺少必要的基础参数 |
| 1001 | 时间戳有误(同一appId对同一接口访问使用了相同的timestamp或时间戳过期-超过300秒) |
| 1002 | 请求频繁(一分钟超过了500次) |
| 1003 | 对称加密出错（计算签名与请求中签名值不同） |
| 1004 | 无效的appId |
| 1005 | openUid与当前登录用户不符 |
| 1100 | 拼接的json字符串格式错误 |
| 1101 | 缺少必要的请求参数,或者传参有误 |
| 9999 | 未知的异常（求的具体接口发生内部异常，请与我们联系） |
| 403 | 未授权 |
1.2. 附录
1.2.1. 附录一、对称加密算法(Java)
其它语言可以仿写
import javax.crypto.Cipher;
import javax.crypto.spec.SecretKeySpec;
import org.apache.commons.lang.StringUtils;
public class AESCipherUtils {
public static final String DEFAULT_CHARSET = "utf-8";
private static final char[] bcdLookup = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };
public static String encryptBcdString(String plain, String key) {
if (StringUtils.isBlank(plain)) {
return null;
}
try {
byte[] plainData = plain.getBytes(DEFAULT_CHARSET);
byte[] keyData = AESCipherUtils.hexStrToBytes(key);
byte[] encryptData = encrypt(plainData, keyData);
return AESCipherUtils.bytesToHexStr(encryptData);
} catch (Exception e) {
}
return null;
}
/**
* 将16进制字符串还原为字节数组.
*/
public static final byte[] hexStrToBytes(String s) {
byte[] bytes;
bytes = new byte[s.length() / 2];
for (int i = 0; i < bytes.length; i++) {
bytes[i] = (byte) Integer.parseInt(s.substring(2 * i, 2 * i + 2), 16);
}
return bytes;
}
/**
* 将字节数组转换为16进制字符串的形式.
*/
public static final String bytesToHexStr(byte[] bcd) {
StringBuffer s = new StringBuffer(bcd.length * 2);
for (int i = 0; i < bcd.length; i++) {
s.append(bcdLookup[(bcd[i] >>> 4) & 0x0f]);
s.append(bcdLookup[bcd[i] & 0x0f]);
}
return s.toString();
}
public static byte[] encrypt(byte[] plainData, byte[] key) {
if (plainData == null) {
return null;
}
try {
Cipher cipher = Cipher.getInstance("AES/ECB/PKCS5Padding", "SunJCE");
SecretKeySpec secretKeySpec = new SecretKeySpec(key, "AES");
cipher.init(Cipher.ENCRYPT_MODE, secretKeySpec);
return cipher.doFinal(plainData);
} catch (Exception e) {
}
return null;
}
}