幫助中心 > API

單點(diǎn)注冊(cè)/登錄(SSO)用戶體系

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


接口介紹

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

接口說明

請(qǐng)求方式:Get

加密鏈接:http://m.53918.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自動(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)用戶體系中無此參與者時(shí),是否允許自動(dòng)注冊(cè):1為允許,0為不允許,默認(rèn)為1
activity 需要跳轉(zhuǎn)的問卷編號(hào),跳轉(zhuǎn)的問卷需要已經(jīng)綁定給了此參與者
sojumpparm 自定義鏈接參數(shù),支持在答卷來源中記錄,跳轉(zhuǎn)時(shí){output}中回傳
r 當(dāng)且僅當(dāng)activity有值時(shí)有效,r = "1" 表示跳轉(zhuǎn)到activity對(duì)應(yīng)問卷的結(jié)果查詢頁
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ì)被過濾。

使用步驟

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

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

3、開發(fā)接口,讓參與者自動(dòng)進(jìn)行登錄。


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

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