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