自定義鏈接參數API（舊版）

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

通過使用自定義鏈接可以通過在問卷鏈接中傳遞參數（如，您系統中的用戶ID）到問卷中，并保存在問卷數據中。同時在填寫完成問卷后訪問您指定的頁面并帶入此參數進行后續處理（例如贈送積分或優惠卷給此用戶）。

使用場景：以CRM系統為例，問卷星的用戶希望對CRM系統中的客戶進行滿意度問卷調查跟蹤，需要將CRM中的用戶ID與問卷星中的答卷進行關聯。這樣的應用場景非常普遍，問卷星的API完全可以滿足類似場景的需求。通過API的方式，即確保了用戶方的內部數據安全（只需要傳遞ID參數），又確保了問卷星數據與企業內部系統數據進行關聯。

1、自定義問卷鏈接

參數名：sojumpparm

數據類型：string（如果包含中文或特殊字符請使用UrlEncode編碼）

最大長度：100個字符（編碼后）

傳遞參數數量：1個（如需傳遞多個，請在您系統中合并為一個后再進行傳遞，推薦使用英文分號（;）進行分割，其他支持的特殊字符有：@、*、~、$）

參數加密：您可以在您系統中將參數加密后，再傳遞加密后的內容；

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

可添加的其他參數：

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

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

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

2、查看答卷來源

當填寫者使用上面的自定義鏈接填寫問卷并提交后，發布者在后臺即可看到來源參數，如下圖：

3、設置回傳鏈接地址

如果您需要將此參數回傳到您的系統中，請在“問卷設置”中設置回傳的頁面地址，并在回傳地址最后加"?userid={output}"，系統將自動把{output}替換為您在自定義鏈接中傳入的參數。注意：如果使用了數據推送的API的功能，參數也會默認傳遞，這里就無需重復設置。如下圖所示：

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

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

4、在問卷中顯示帶進來的參數

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

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

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

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