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