該功能接口僅限為旗艦版用戶提供。
使用該接口,可以通過SSO(單點登錄)的方式讓參與者登錄到您創(chuàng)建的用戶體系中。適用的場景為:您針對參與者已經(jīng)有了一套用戶系統(tǒng),但是需要使用問卷星用戶體系進行考試、問卷的集中發(fā)放,使用該接口后參與者只需要登錄您原有的系統(tǒng),就可以使用一個按鈕無縫轉(zhuǎn)移到問卷星的用戶體系中。
請求方式:Get
加密鏈接:http://malifuke.cn/user/loginform.aspx?u=&userSystem=&systemId=&appid=&uid=&uname=&udept=&uextf=&islogin=&ts=&sign=
參數(shù)名 | 參數(shù)說明 | 是否必須 |
---|---|---|
u | 您賬戶用戶名,為固定值 | 是 |
userSystem | 用戶體系的類型,為固定值 1 | 是 |
systemId | 用戶體系的ID,為固定值 | 是 |
appid | 開發(fā)ID,可以在“API自動登錄”彈框查詢到 | 是 |
uid | 參與者ID,鑒別參與者唯一身份的ID | 是 |
ts | 時間戳,從1970-01-01 00:00:00開始到現(xiàn)在的秒數(shù),有效期為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 | 需要跳轉(zhuǎn)的問卷編號,跳轉(zhuǎn)的問卷需要已經(jīng)綁定給了此參與者 | 否 |
sojumpparm | 自定義鏈接參數(shù),支持在答卷來源中記錄,跳轉(zhuǎn)時{output}中回傳 | 否 |
r | 當且僅當activity有值時有效,r = "1" 表示跳轉(zhuǎn)到activity對應問卷的結(jié)果查詢頁 | 否 |
returnurl | 指定登錄成功后的跳轉(zhuǎn)地址 | 否 |
pagetype | 跳轉(zhuǎn)地址類型:默認為待參與列表時可以不帶此參數(shù) 0: 待參與列表 1:已參與列表 2: 積分排行 注:當且僅當returnurl參數(shù)不為空時有效 |
否 |
以上參數(shù)中:
u\userSystem\systemId 在同一個用戶體系中均為固定值,在“API自動登錄”彈窗的接口鏈接中可以直接復制獲取;
appid和appkey也可以直接在“API自動登錄”彈窗中獲取到;
uid\uname\udept\uextf\islogin\ts\sign為變量,需要用戶根據(jù)實際情況傳入;
注意:傳遞的參數(shù)值前后任意形式的空格均會被過濾。
1、登錄問卷星后臺創(chuàng)建一個用戶體系(不能使用微信服務號和企業(yè)微信的方式創(chuàng)建);
2、用戶體系的字段可以自由設置,“用戶ID”為必須字段,需注意“”添加的字段和隨后傳入的字段需保持一致;
3、開發(fā)接口,讓參與者自動進行登錄。
如果需要通過接口批量注冊用戶體系的參與者,或者說一鍵同步您系統(tǒng)中通訊錄到用戶體系中,請參考此開發(fā)文檔:用戶體系參與者批量注冊API接口