“成绩云接口开发文档”的版本间的差异

来自成绩云帮助中心
跳转至: 导航搜索
查询所有用户列表
单点登录
第10行: 第10行:
  
 
== 单点登录 ==
 
== 单点登录 ==
 +
单点登录流程说明:<br/>
 +
1. 第三方平台内添加成绩云访问单点登录链接,点击链接访问成绩云。<br/>
 +
2. 成绩云接收来自第三方的的访问参数,查询站点信息。(成绩云是分学段建立站点的;如果一个学校包含了小学、初中、高中,那么成绩云中将分别建立小学、初中、高中三个站点。成绩云分学段建立的站点将使用第三方平台给定的学校唯一标识建立站点关联关系)。<br/>
 +
3. 第三方平台给定的学校没有包含多个学段,则开始验证用户信息。<br/>
 +
4. 第三方平台给定的学校包含多个学段,成绩云将会显示选择站点页面。选择站点页面将列举出访问用户可选择的站点。用户选择对应的站点后,则开始验证用户信息。<br/>
 +
 +
单点登录链接:<br/>
 +
https://chengjiyun.com/portal/XXX?schoo_id=xxx&uid=xxx&type=xxx$sign=87d557e67ea74257665cff4bc42d1b50
 +
 +
PHP签名算法如下:<br/>
 +
 +
{{{
 +
    echo 123;
 +
}}}
  
 
== 查询用户 ==
 
== 查询用户 ==

2019年1月9日 (三) 16:19的版本

前言

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

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

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

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

单点登录

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

单点登录链接:
https://chengjiyun.com/portal/XXX?schoo_id=xxx&uid=xxx&type=xxx$sign=87d557e67ea74257665cff4bc42d1b50

PHP签名算法如下:

{{{

   echo 123;

}}}

查询用户

查询所有用户列表

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

查询学生列表

查询教师列表

查询家长列表

查询管理员列表

更新用户

查询班级任教信息列表

更新班级任教信息列表

常见问题