该功能接口仅限为旗舰版用户提供。
使用该接口,可以通过SSO(单点登录)的方式让参与者登录到您创建的用户体系中。适用的场景为:您针对参与者已经有了一套用户系统,但是需要使用问卷星用户体系进行考试、问卷的集中发放,使用该接口后参与者只需要登录您原有的系统,就可以使用一个按钮无缝转移到问卷星的用户体系中。
请求方式:Get
加密链接:https://www.wjx.cn/user/loginform.aspx?u=&userSystem=&systemId=&appid=&uid=&uname=&udept=&uextf=&islogin=&ts=&sign=
参数名 | 参数说明 | 是否必须 |
---|---|---|
u | 您账户用户名,为固定值 | 是 |
userSystem | 用户体系的类型,为固定值 1 | 是 |
systemId | 用户体系的ID,为固定值 | 是 |
appid | 开发ID,可以在“API自动登录”弹框查询到 | 是 |
uid | 参与者ID,鉴别参与者唯一身份的ID | 是 |
ts | 时间戳,从1970-01-01 00:00:00开始到现在的秒数,有效期为300秒 | 是 |
encode | 签名验证方式,目前支持sha1和sm3,不传或传入不合法时,默认使用:sha1 | 否 |
sign | 加密签名,算法sign=sha1(appid+appkey+uid+ts) 当encode=sm3时,sign=sm3(appid+appkey+uid+ts) 点击查看 签名示例 |
是 |
upass | 参与者初始登录密码,用于参与者手动登录(可使用比如用户ID或其后6位等规则),传递后会加密存储。用户体系需添加此字段,否则接口传入也会被舍弃 | 否 |
uname | 参与者姓名,用户体系需添加此字段,否则接口传入也会被舍弃 | 否 |
udept | 参与者部门,用户体系需添加此字段,否则接口传入也会被舍弃 | 否 |
uextf | 参与者附加信息,用户体系需添加此字段,否则接口传入也会被舍弃 | 否 |
islogin | 当用户体系中无此参与者时,是否允许自动注册:1为允许,0为不允许,默认为1 | 否 |
activity | 需要跳转的问卷编号,跳转的问卷需要已经绑定给了此参与者 | 否 |
sojumpparm | 自定义链接参数,支持在答卷来源中记录,跳转时{output}中回传 | 否 |
r | 当且仅当activity有值时有效,r = "1" 表示跳转到activity对应问卷的结果查询页 | 否 |
returnurl | 指定登录成功后的跳转地址 | 否 |
pagetype | 跳转地址类型:默认为待参与列表时可以不带此参数 0: 待参与列表 1:已参与列表 2: 积分排行 注:当且仅当returnurl参数不为空时有效 |
否 |
以上参数中:
u\userSystem\systemId 在同一个用户体系中均为固定值,在“API自动登录”弹窗的接口链接中可以直接复制获取;
appid和appkey也可以直接在“API自动登录”弹窗中获取到;
uid\uname\udept\uextf\islogin\ts\sign为变量,需要用户根据实际情况传入;
注意:传递的参数值前后任意形式的空格均会被过滤。
1、登录问卷星后台创建一个用户体系(不能使用微信服务号和企业微信的方式创建);
2、用户体系的字段可以自由设置,“用户ID”为必须字段,需注意“”添加的字段和随后传入的字段需保持一致;
3、开发接口,让参与者自动进行登录。
如果需要通过接口批量注册用户体系的参与者,或者说一键同步您系统中通讯录到用户体系中,请参考此开发文档:用户体系参与者批量注册API接口