帮助中心

单点注册/登录(SSO)用户体系

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


接口介绍

使用该接口,可以通过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接口

非常感谢您的耐心阅读,请在下方提供您对本篇帮助的反馈,以便我们持续改进本文。
已解决 未解决
  • 400-993-5858
  • cs@wjx.cn
  • 问卷调查网站,广告合作 广告合作
    请扫码添加专员
    广告合作
长沙冉星信息科技有限公司 版权所有    ICP证:湘B2-20220508    湘ICP备17005436号-1    湘公网安备 43019002000245号
网站数据来源于问卷星官方数据库    服务协议    隐私条款    举报