幫助中心 > 自定義鏈接

問卷星API

如需更多接口請點擊:問卷星API接口總覽

一、填寫問卷時傳遞參數(如,用戶ID)

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

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

1、自定義問卷鏈接

參數名:sojumpparm

數據類型:string(如果包含中文或特殊字符請使用UrlEncode編碼)

最大長度:100個字符(編碼后)

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

加密傳遞:您可以在您系統中加密后,在傳遞加密后的內容

完整的鏈接示例:http://www.lenbus.co/jq/3795229.aspx?sojumpparm=wenjuanxing

2、查看答卷來源

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

3、設置回傳鏈接地址

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

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

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

如有問題,請聯系我們

二、數據推送API

如果您需要將某個問卷新提交的數據推送到指定URL,您可以使用此API,尊享版該API默認是開啟狀態。點擊這里,可以搭建測試環境。

例如指定URL為http://yourdomain.com/callback,則問卷星會以JSON格式POST該答卷數據到指定的URL。

POST http://yourdomain.com/callback Content-Type: application/json

示例問卷對應的json數據 {"activity": "5657754","timetaken":"528","submittime":"2016-08-23 10:01:59", "q1":"1","q2": "測試","q3","1,2" } 解析如下:

activity表示該問卷的ID;

timetaken表示從打開問卷到填寫提交所用時間,528表示528秒;

submittime表示提交的時間點;

q1表示第1題,值“1”表示用戶選擇了第一個選項;

q2表示第2題,值“測試”表示用戶輸入的內容;

q3表示第3題,值“1,2”表示用戶同時選擇了第1個和第2個選項。

提示:

(1)部分復雜題型不能推送,比如矩陣類型題目、表格類型題目等。

(2)推送失敗,系統會自動重新推送。如果1分鐘內連續出錯超過3次,該問卷的數據推送過程將被暫停30分鐘。

(3)如果使用了數據推送API,同時也使用了自定義鏈接參數,sojumpparm參數帶進來的內容也會推送,無需使用“自定義鏈接參數”功能中的頁面跳轉傳遞參數。

(4)點擊查看各題型的推送詳情

開發指南:

1、PHP獲取Json數據:可以使用file_get_contents("php://input")或者$GLOBALS['HTTP_RAW_POST_DATA']

2、Python django:可以使用request.raw_post_data來獲取Json數據

3、java代碼:使用org.apache.commons.io.IOUtils來獲取json字符串:

  1. String jsonString = IOUtils.toString(request.getInputStream());
  2. JSONObject json = new JSONObject(jsonString);

4、C#代碼:讀取Request.InputStream數據:

  1. Stream stream = Request.InputStream;
  2. Byte[] byteData = new Byte[stream.Length];
  3. stream.Read(byteData, 0, (Int32)stream.Length);
  4. string jsonData = Encoding.UTF8.GetString(byteData);

更多開發接口

更多開放接口

其他

1、支持將自定義鏈接參數顯示在段落說明或題干中。插入方法:將[sojumpparm]這個字段輸入在段落說明或題干中,如下圖所示。

示例:http://www.lenbus.co/jq/37943379.aspx?sojumpparm=任亞軍

如需以上功能,請聯系我們



---END---
非常感謝您的耐心閱讀,請在下方提供您對本篇幫助的反饋,以便我們持續改進本文。
已解決 未解決
長沙冉星信息科技有限公司 版權所有    ICP證:43019002000245    湘ICP備17005436號-1    湘公網安備 43019002000245號   認證聯盟   舉報
網站數據來源于問卷星官方數據庫
澳洲幸运全天计划预测