自定義鏈接參數(shù)API（舊版）

一、在問卷鏈接中傳遞參數(shù)（如，用戶ID）

通過使用自定義鏈接可以通過在問卷鏈接中傳遞參數(shù)（如，您系統(tǒng)中的用戶ID）到問卷中，并保存在問卷數(shù)據(jù)中。同時(shí)在填寫完成問卷后訪問您指定的頁面并帶入此參數(shù)進(jìn)行后續(xù)處理（例如贈(zèng)送積分或優(yōu)惠卷給此用戶）。

使用場(chǎng)景：以CRM系統(tǒng)為例，問卷星的用戶希望對(duì)CRM系統(tǒng)中的客戶進(jìn)行滿意度問卷調(diào)查跟蹤，需要將CRM中的用戶ID與問卷星中的答卷進(jìn)行關(guān)聯(lián)。這樣的應(yīng)用場(chǎng)景非常普遍，問卷星的API完全可以滿足類似場(chǎng)景的需求。通過API的方式，即確保了用戶方的內(nèi)部數(shù)據(jù)安全（只需要傳遞ID參數(shù)），又確保了問卷星數(shù)據(jù)與企業(yè)內(nèi)部系統(tǒng)數(shù)據(jù)進(jìn)行關(guān)聯(lián)。

1、自定義問卷鏈接

參數(shù)名：sojumpparm

數(shù)據(jù)類型：string（如果包含中文或特殊字符請(qǐng)使用UrlEncode編碼）

最大長(zhǎng)度：100個(gè)字符（編碼后）

傳遞參數(shù)數(shù)量：1個(gè)（如需傳遞多個(gè)，請(qǐng)?jiān)谀到y(tǒng)中合并為一個(gè)后再進(jìn)行傳遞，推薦使用英文分號(hào)（;）進(jìn)行分割，其他支持的特殊字符有：@、*、~、$）

參數(shù)加密：您可以在您系統(tǒng)中將參數(shù)加密后，再傳遞加密后的內(nèi)容；

示例鏈接：http://m.kaben.cc/vj/mpPXl9B.aspx?sojumpparm=wenjuanxing

可添加的其他參數(shù)：

(1)時(shí)間戳參數(shù)：endts，可選參數(shù)，表示截止時(shí)間的時(shí)間戳，精確到秒；

(2)簽名校驗(yàn)：parmsign，可選參數(shù)，parmsign=sha1(activity+sojumpparm+endts+推送密鑰)，其中activity為問卷ID、endts為空時(shí)不參與簽名、推送秘鑰需咨詢服務(wù)顧問獲取。簽名生成

(3)完整鏈接示例：http://m.kaben.cc/vj/mpPXl9B.aspx?sojumpparm=wenjuanxing&endts=1603286043&parmsign=***

2、查看答卷來源

當(dāng)填寫者使用上面的自定義鏈接填寫問卷并提交后，發(fā)布者在后臺(tái)即可看到來源參數(shù)，如下圖：

3、設(shè)置回傳鏈接地址

如果您需要將此參數(shù)回傳到您的系統(tǒng)中，請(qǐng)?jiān)凇皢柧碓O(shè)置”中設(shè)置回傳的頁面地址，并在回傳地址最后加"?userid={output}"，系統(tǒng)將自動(dòng)把{output}替換為您在自定義鏈接中傳入的參數(shù)。注意：如果使用了數(shù)據(jù)推送的API的功能，參數(shù)也會(huì)默認(rèn)傳遞，這里就無需重復(fù)設(shè)置。如下圖所示：

設(shè)置回傳地址示例：https://www.yourwebsite.com/complete.aspx?userid={output}

實(shí)際回傳地址樣例：https://www.yourwebsite.com/complete.aspx?userid=wenjuanxing

4、在問卷中顯示帶進(jìn)來的參數(shù)

支持將自定義鏈接參數(shù)顯示在段落說明或題干中。插入方法：將[sojumpparm]這個(gè)字段輸入在段落說明或題干中，如下圖所示（顯示帶進(jìn)來的參數(shù)僅限尊享版用戶使用）：

示例：http://m.kaben.cc/jq/37943379.aspx?sojumpparm=張三

二、使用鏈接參數(shù)控制問卷中題目的選擇

使用自定義鏈接參數(shù)控制問卷中部分題目的選擇和填寫，通過這些鏈接進(jìn)入問卷，部分題目可以自動(dòng)選擇和填寫，不再需要填寫者手動(dòng)作答，點(diǎn)擊這里了解詳情。