== 前言 ==
+
== <p style="background:#6a9ee4;padding:8px 12px;color:#ffffff;">前言</p> ==
    
本文档针对需要对接成绩云系统的平台而编写。
 
本文档针对需要对接成绩云系统的平台而编写。
   −
接入成绩云的平台需要先联系知未科技研发,获取2个基本参数:平台ID('''platform'''),平台密钥('''key''')。
+
接入成绩云的平台需要先联系知未科技研发,获取2个基本参数:平台ID'''[platform]''',平台密钥'''[key]'''。这两个参数也可以反过来向知未科技提供。
   −
== 单点登录 ==
+
然后提供一个接口URL前缀'''[apiBaseUrl]''',后面所有的接口都基于这个前缀。凡是接口URL是https://chengjiyun.com前缀的,说明这个接口由第三方向成绩云发起请求。而如果接口URL前缀是'''[apiBaseUrl]''',说明接口是由成绩云向第三方发起请求。
   −
== 用户查询 ==
+
为每一所接入学校向知未提供一个'''[orgId]'''。
   −
== 用户更新 ==
+
== <p style="background:#6a9ee4;padding:8px 12px;color:#ffffff;">单点登录</p> ==
 +
[[文件:login.png]] <br/><br/><br/>
 +
;<p style="background:#999a9c;padding:8px 12px;color:#ffffff;display:inline-block;">单点登录流程说明</p><br/>
 +
1. 第三方平台内添加成绩云访问单点登录链接,点击链接访问成绩云。<br/>
 +
2. 成绩云接收来自第三方的的访问参数,查询站点信息。(成绩云是分学段建立站点的;如果一个学校包含了小学、初中、高中,那么成绩云中将分别建立小学、初中、高中三个站点。成绩云分学段建立的站点将使用第三方平台给定的学校唯一标识建立站点关联关系)。<br/>
 +
3. 第三方平台给定的学校没有包含多个学段,则开始验证用户信息。<br/>
 +
4. 第三方平台给定的学校包含多个学段,成绩云将会显示选择站点页面。选择站点页面将列举出访问用户可选择的站点。用户选择对应的站点后,则开始验证用户信息。<br/><br/>
   Call to undefined function each() at /mnt/xvdc1/chengjiyun/public/wiki/includes/diff/DairikiDiff.php:438