单点登录(SSO)子账户接口

该功能接口仅限为旗舰版用户提供

目录

一、SSO创建和登录接口

二、获取SSO子账户问卷列表接口

三、获取SSO子账户答卷数据接口

四、SSO子账户参与者端接口

一、SSO创建和登录接口

接口介绍

使用该接口，可以通过单点登录（SSO）的方式创建子账户，创建成功之后可以通过此接口登录子账户。使用此接口创建的用户，属于主账户下属的子账户，权益同主账户同步。除创建和登录方式不同外，其他权益、设置同手动创建的子账户完全一致。

接口参数说明

请求方式：Get

接口链接：https://www.wjx.cn/zunxiang/login.aspx?appid=&subuser=&mobile=&email=&roleId=&ts=&sign=

子账户的创建/登录和删除

创建：第一次使用以上接口时，就是子账户的创建过程；

登录：子账户登录和创建使用相同的接口，其中手机号码、邮箱、角色三个字段，仅在首次创建时有效，在第二次登录时如果三个字段信息有更改，也不会将传递信息更新到问卷星系统；

删除：如需删除子账户，需要主账户登录后，在多用户管理页面手动删除。需要注意是：在您自己系统删除一个员工账户后，无法自动同步删除其在问卷星对应的子账户。

二、获取SSO子账户问卷列表接口

接口介绍

通过此接口，可以获取某一个子账户问卷管理员名下的问卷列表。

接口参数说明

请求方式：Get

接口链接：https://www.wjx.cn/zunxiang/getuserq.aspx?appid=&username=&ts=&folder=&sign=

获取到数据说明

此接口会有10分钟的缓存时间，新增的问卷可能需要10分钟以后才能获取。如果需要实时获取，请在接口URL参数中增加&nocache=1（增加参数后，接口每分钟只能调用5次）。

数据格式：JSON

数据示例： [{"qid":"89767","name":"新考试","begindate":"2017-08-20 11:52:43","answercount":"5","pcurl":"https://www.wjx.cn/jq/89767.aspx","murl":"https://www.wjx.cn/m/89767.aspx"},{"qid":"89819","name":"考试","begindate":"2017-08-18 21:21:35","answercount":"4","pcurl":"https://www.wjx.cn/jq/89819.aspx","murl":"https://www.wjx.cn/m/89819.aspx"}]

qid：问卷ID

name：问卷标题

begindata：问卷的创建时间

answercount：当前问卷答卷数
desc:问卷说明（默认不返回），如果需要此字段，请在接口URL参数中增加&includedesc=1。
pcurl: PC端问卷访问链接
murl: 移动端问卷访问链接

三、获取SSO子账户答卷数据接口

接口介绍

通过此接口可以获取到部分答卷数据，包括：提交序号、参与者姓名、总分、提交时间、提交所用时间。需要注意的是，只有答卷总数少于20000才能使用此接口，而且此接口只能获取到部分数据而且全部答卷详情数据。如需获取全部答卷详情数据，可以参考：数据推送的API接口。

接口参数说明

请求方式：Get

接口链接：https://www.wjx.cn/zunxiang/getjoinlist.aspx?appid=&activity=&ts=&sign=&pageindex=&pagesize=

获取到数据说明

数据格式：JSON

数据示例：

[{"parterjoiner":"test2","totalvalue":"15","index":"3","timetaken":"8","submittime":"2017-08-20 14:25:39"},{"parterjoiner":"test3","totalvalue":"15","index":"4","timetaken":"141","submittime":"2017-08-20 14:38:55"}]

parterjoiner：参与者姓名

totalvalue：当前答卷得分

index：当前答卷序号

timetaken：当前答卷作答所用的时间，单位：秒

submittime：当前答卷的提示时间

四、SSO子账户参与者端接口

接口介绍

使用该接口，做为问卷或考试填写参与者的登录之后，可看到一个完善的填写参与者的用户体系，查看到自己需要作答哪些问卷、已经完成了哪些问卷、积分排行等等信息。

接口参数说明

请求方式：get

加密链接参数如下：https://www.wjx.cn/zunxiang/qlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

访问其他页面

以上接口填写者参与者点击后访问的是用户体系的主页，还可以通过携带参数访问其他不同的页面，如：

1、待参与页面：https://www.wjx.cn/zunxiang/qlist.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

2、已参与页面：https://www.wjx.cn/zunxiang/qlistjoin.aspx?appid=&username=&joiner=&realname=&dept=&extf=&ts=&sign=

3、答卷详情页：https://www.wjx.cn/zunxiang/joinrelquery.aspx?appid=&username=&joiner=&activity=&joinid=&realname=&dept=&extf=&ts=&sign=，如果需要隐藏返回按钮，请在参数后面加上&noback=1。

访问答卷详情页，需增加两个参数：activity（问卷ID）和joinid（答卷流水号，需使用数据推送接口获取），同时加密签名算法改变为：sign=sha1(appid+appkey+username+joiner+activity+joinid+realname+dept+extf+ts)