幫助中心

單點注冊/登錄(SSO)用戶體系

該功能接口僅限為旗艦版用戶提供。


接口介紹

使用該接口,可以通過SSO(單點登錄)的方式讓參與者登錄到您創(chuàng)建的用戶體系中。適用的場景為:您針對參與者已經(jīng)有了一套用戶系統(tǒng),但是需要使用問卷星用戶體系進行考試、問卷的集中發(fā)放,使用該接口后參與者只需要登錄您原有的系統(tǒng),就可以使用一個按鈕無縫轉(zhuǎn)移到問卷星的用戶體系中。

接口說明

請求方式:Get

加密鏈接:http://m.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,不傳或傳入不合法時,默認(rèn)使用:sha1
sign 加密簽名,算法sign=sha1(appid+appkey+uid+ts)
當(dāng)encode=sm3時,sign=sm3(appid+appkey+uid+ts)
點擊查看 簽名示例
upass 參與者初始登錄密碼,用于參與者手動登錄(可使用比如用戶ID或其后6位等規(guī)則),傳遞后會加密存儲。用戶體系需添加此字段,否則接口傳入也會被舍棄
uname 參與者姓名,用戶體系需添加此字段,否則接口傳入也會被舍棄
udept 參與者部門,用戶體系需添加此字段,否則接口傳入也會被舍棄
uextf 參與者附加信息,用戶體系需添加此字段,否則接口傳入也會被舍棄
islogin 當(dāng)用戶體系中無此參與者時,是否允許自動注冊:1為允許,0為不允許,默認(rèn)為1
activity 需要跳轉(zhuǎn)的問卷編號,跳轉(zhuǎn)的問卷需要已經(jīng)綁定給了此參與者
sojumpparm 自定義鏈接參數(shù),支持在答卷來源中記錄,跳轉(zhuǎn)時{output}中回傳
r 當(dāng)且僅當(dāng)activity有值時有效,r = "1" 表示跳轉(zhuǎn)到activity對應(yīng)問卷的結(jié)果查詢頁
returnurl 指定登錄成功后的跳轉(zhuǎn)地址
pagetype 跳轉(zhuǎn)地址類型:默認(rèn)為待參與列表時可以不帶此參數(shù)
0: 待參與列表 1:已參與列表 2: 積分排行
注:當(dāng)且僅當(dāng)returnurl參數(shù)不為空時有效

以上參數(shù)中:

u\userSystem\systemId 在同一個用戶體系中均為固定值,在“API自動登錄”彈窗的接口鏈接中可以直接復(fù)制獲?。?/p>

appid和appkey也可以直接在“API自動登錄”彈窗中獲取到;


uid\uname\udept\uextf\islogin\ts\sign為變量,需要用戶根據(jù)實際情況傳入;

注意:傳遞的參數(shù)值前后任意形式的空格均會被過濾。

使用步驟

1、登錄問卷星后臺創(chuàng)建一個用戶體系(不能使用微信服務(wù)號和企業(yè)微信的方式創(chuàng)建);

2、用戶體系的字段可以自由設(shè)置,“用戶ID”為必須字段,需注意“”添加的字段和隨后傳入的字段需保持一致;

3、開發(fā)接口,讓參與者自動進行登錄。


如果需要通過接口批量注冊用戶體系的參與者,或者說一鍵同步您系統(tǒng)中通訊錄到用戶體系中,請參考此開發(fā)文檔:用戶體系參與者批量注冊API接口

非常感謝您的耐心閱讀,請在下方提供您對本篇幫助的反饋,以便我們持續(xù)改進本文。
已解決 未解決
長沙冉星信息科技有限公司 版權(quán)所有    ICP證:湘B2-20220508    湘ICP備17005436號-1    湘公網(wǎng)安備 43019002000245號
網(wǎng)站數(shù)據(jù)來源于問卷星官方數(shù)據(jù)庫    服務(wù)協(xié)議    隱私條款    舉報