帮助中心 > API
单点注册/登录（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接口
已解决
未解决
