成绩云接口开发文档

前言

本文档针对需要对接成绩云系统的平台而编写。

接入成绩云的平台需要先联系知未科技研发，获取2个基本参数：平台ID[platform]，平台密钥[key]。这两个参数也可以反过来向知未科技提供。

然后提供一个接口URL前缀[apiBaseUrl]，后面所有的接口都基于这个前缀。

为每一所接入学校向知未提供一个[orgId]。

单点登录

单点登录流程说明：

1. 第三方平台内添加成绩云访问单点登录链接，点击链接访问成绩云。
2. 成绩云接收来自第三方的的访问参数，查询站点信息。（成绩云是分学段建立站点的；如果一个学校包含了小学、初中、高中，那么成绩云中将分别建立小学、初中、高中三个站点。成绩云分学段建立的站点将使用第三方平台给定的学校唯一标识建立站点关联关系）。
3. 第三方平台给定的学校没有包含多个学段，则开始验证用户信息。
4. 第三方平台给定的学校包含多个学段，成绩云将会显示选择站点页面。选择站点页面将列举出访问用户可选择的站点。用户选择对应的站点后，则开始验证用户信息。

单点登录链接：

 [apiBaseUrl]/[paltform]?orgId=[学校ID]&account=[账号]&type=[角色]&timestamp=[当前时间戳]&sign=[加密串]

paltform:平台ID
请求方法:GET
接口方向:第三方→成绩云
访问参数：

访问参数

参数	类型	是否必填	描述
orgId	string	是	学校ID
account	string	是	账号
type	string	是	角色
timestamp	int	是	时间戳time()
sign	string	是	加密串,使用sign()方法加密

PHP签名算法如下：

//$key 平台密钥
function sign($data, $key) {
  ksort($data);                                    // 正向排序
  $key_str = urldecode(http_build_query($data));  // 连接字符串
  $key_str .= '&key=' . $key;                     // 拼接key
  return md5($key_str);
}

$data = array(
   'orgId'=> 2345,
   'account'=> 4567,
   'type'=> ,
   'timestamp'  => time(),
);
$sign = sign($data, $key);

查询用户

查询所有用户列表

此接口是下面其它接口的超集，后面的接口通过role参数查询子集。