幫助中心 > API
單點注冊/登錄（SSO）用戶體系
該功能接口僅限為旗艦版用戶提供。
接口介紹
使用該接口，可以通過SSO（單點登錄）的方式讓參與者登錄到您創(chuàng)建的用戶體系中。適用的場景為：您針對參與者已經有了一套用戶系統(tǒng)，但是需要使用問卷星用戶體系進行考試、問卷的集中發(fā)放，使用該接口后參與者只需要登錄您原有的系統(tǒng)，就可以使用一個按鈕無縫轉移到問卷星的用戶體系中。
接口說明
請求方式:Get
加密鏈接：http://cgior.cn/user/loginform.aspx?u=&userSystem=&systemId=&appid=&uid=&uname=&udept=&uextf=&islogin=&ts=&sign=
| 參數名 | 參數說明 | 是否必須 |
|---|---|---|
| u | 您賬戶用戶名，為固定值 | 是 |
| userSystem | 用戶體系的類型，為固定值 1 | 是 |
| systemId | 用戶體系的ID，為固定值 | 是 |
| appid | 開發(fā)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位等規(guī)則），傳遞后會加密存儲。用戶體系需添加此字段，否則接口傳入也會被舍棄 | 否 |
| 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自動登錄”彈窗的接口鏈接中可以直接復制獲?。?/p>
appid和appkey也可以直接在“API自動登錄”彈窗中獲取到；
uid\uname\udept\uextf\islogin\ts\sign為變量，需要用戶根據實際情況傳入；
注意：傳遞的參數值前后任意形式的空格均會被過濾。
使用步驟
1、登錄問卷星后臺創(chuàng)建一個用戶體系（不能使用微信服務號和企業(yè)微信的方式創(chuàng)建）；
2、用戶體系的字段可以自由設置，“用戶ID”為必須字段，需注意“”添加的字段和隨后傳入的字段需保持一致；
3、開發(fā)接口，讓參與者自動進行登錄。
如果需要通過接口批量注冊用戶體系的參與者，或者說一鍵同步您系統(tǒng)中通訊錄到用戶體系中，請參考此開發(fā)文檔：用戶體系參與者批量注冊API接口
已解決
未解決
