Open API
登录
URL: https://[site_url]/?q=school-users/api/login
POST参数：id - 学号, pass - 密码
返回：JSON结构字符串，其中uid和token属性将用于其它接口身份验证。
注意：密码错误如果超过10次，则该账号6小时内不能通过此API登录。
PHP示例代码：
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,"https://chengjiyun.com/demo/?q=school-users/api/login");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, "id=20120101&pass=123");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, TRUE);
$output = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($http_code == 200 && $output) {
$result = json_decode($output);
var_dump($result);
} else {
echo "http_code: $http_code\n";
echo curl_error($ch);
}
curl_close ($ch);
示例结果：
object(stdClass)[202]
public 'uid' => string '90' (length=2)
public 'token' => string '7338c0954acba04b7dd5b8b74dfe2130' (length=32)
public 'msg' => string 'login succeed' (length=13)
获取学生考试列表
URL: http://[site_url]/?q=transcripts/api/get-student-exams/[uid]/[token]
其中，uid即token的值应该在登录的接口中获取。
返回：JSON结构字符串，示例结果如下
{"exams":
[
{"tid":"58",
"name":"2012-2013\u5b66\u5e74\u5ea6\u4e0b\u5b66\u671f\u9ad8\u4e00\u671f\u4e2d\u8003\u8bd5",
"short_name":"\u9ad8\u4e00\u4e0b\u671f\u4e2d",
"exam_time":"1367078400",
"update_time":"1367333382"
},
{"tid":"79",
"name":"2012\u7ea7\u9ad8\u4e00\u4e0b\u5b66\u671f\u671f\u672b\u8003\u8bd5",
"short_name":"\u9ad8\u4e00\u671f\u672b",
"exam_time":"1373472000",
"update_time":"1377961856"
}
]
}
获取学生考试个人详细信息
URL: http://[site_url]/?q=transcripts/api/get-student-exam-info/[uid]/[token]/[tid]
其中，uid即token的值应该在登录的接口中获取，tid的值表示考试ID，从“学生考试列表”接口返回结果中获取
返回：JSON结构字符串，示例结果如下
{"table":{"header":["","\u8bed\u6587","\u6570\u5b66","\u82f1\u8bed","\u653f\u6cbb","\u5386\u53f2","\u5730\u7406","\u516d\u79d1"],"rows":[["\u5206\u6570",114,97,116,82,68,88,565],["\u73ed\u5185\u5e73\u5747\u5206",104.5,89.7,101.4,65.7,64.7,81.8,507.8],["\u73ed\u5185\u540d\u6b21","6","11","4","3","17","13","7"],["\u79d1\u5185\u5e73\u5747\u5206",106.6,93.4,104.1,66.9,65.6,82.7,519.9],["\u79d1\u5185\u540d\u6b21","85","193","93","27","192","128","85"]]}}
为方便查看数据结构，下面给出JSON字符串对应的PHP对象结构：
object(stdClass)[230]
public 'table' =>
object(stdClass)[231]
public 'header' =>
array (size=8)
0 => string '' (length=0)
1 => string '语文' (length=6)
2 => string '数学' (length=6)
3 => string '英语' (length=6)
4 => string '政治' (length=6)
5 => string '历史' (length=6)
6 => string '地理' (length=6)
7 => string '六科' (length=6)
public 'rows' =>
array (size=5)
0 =>
array (size=8)
0 => string '分数' (length=6)
1 => int 114
2 => int 97
3 => int 116
4 => int 82
5 => int 68
6 => int 88
7 => int 565
1 =>
array (size=8)
0 => string '班内平均分' (length=15)
1 => float 104.5
2 => float 89.7
3 => float 101.4
4 => float 65.7
5 => float 64.7
6 => float 81.8
7 => float 507.8
2 =>
array (size=8)
0 => string '班内名次' (length=12)
1 => string '6' (length=1)
2 => string '11' (length=2)
3 => string '4' (length=1)
4 => string '3' (length=1)
5 => string '17' (length=2)
6 => string '13' (length=2)
7 => string '7' (length=1)
3 =>
array (size=8)
0 => string '科内平均分' (length=15)
1 => float 106.6
2 => float 93.4
3 => float 104.1
4 => float 66.9
5 => float 65.6
6 => float 82.7
7 => float 519.9
4 =>
array (size=8)
0 => string '科内名次' (length=12)
1 => string '85' (length=2)
2 => string '193' (length=3)
3 => string '93' (length=2)
4 => string '27' (length=2)
5 => string '192' (length=3)
6 => string '128' (length=3)
7 => string '85' (length=2)
注意：本示例结果并不完整，例如会包含Highcharts图表绘制数据。
