自定義鏈接參數(shù)API

什么是自定義鏈接

自定義鏈接是指：可以在普通問卷鏈接的基礎(chǔ)上添加參數(shù)，將參數(shù)值傳遞到問卷中，并存儲為問卷的答卷數(shù)據(jù)。

例如：您有自己的用戶系統(tǒng)，在為用戶配置問卷參與鏈接時，可以通過參數(shù)帶入用戶的各種信息，跟蹤答題狀態(tài)，回傳作答狀態(tài)及數(shù)據(jù)。

如果想做全局的配置，開發(fā)一次每個問卷都可以攜帶共同的一組參數(shù)，可以點擊此處了解。

場景案例

使用要求

免費版用戶無法使用自定義鏈接的功能。企業(yè)標準版及尊享版可使用默認的「sojumpparm」參數(shù)，無法添加更多參數(shù)。旗艦版及以上，不僅可以使用默認的「sojumpparm」參數(shù)，還可以添加更多的參數(shù)。

默認參數(shù)和添加題目參數(shù)

1、默認參數(shù)

問卷星默認會提供一個「sojumpparm」參數(shù)，通過此參數(shù)傳遞進來的數(shù)據(jù)，會保存在答卷的「來源詳情」的字段。該參數(shù)為：string類型（如果包含中文或特殊字符請使用UrlEncode編碼）、最大長度為100個字符。

2、添加題目參數(shù)

如果需要傳遞更多的參數(shù)，可以在頁面上點擊「添加參數(shù)」，這里添加的參數(shù)必須是問卷中的「填空題」、「單選題」或「多級下拉題」，所以需要在設(shè)計問卷時添加好對應的問卷題目，如果不想讓填寫者看到這些題目，可以將這些題目設(shè)置為隱藏狀態(tài)。

題目參數(shù)傳遞進來的數(shù)據(jù)，會存儲在對應的題目數(shù)據(jù)中，同填寫者正常作答的數(shù)據(jù)一致。題目參數(shù)的類型依據(jù)對應的題目類型的不同而不同，如「填空題」為字符串類型，「單選題」「多級下拉題」為選擇類型。

參數(shù)的代入

1、開發(fā)組裝鏈接參數(shù)

一般來說使用「開發(fā)組裝鏈接參數(shù)」都需要貴方開發(fā)人員參與，依據(jù)本篇文檔進行自定義鏈接參數(shù)的組裝，帶入貴方系統(tǒng)中的必要字段。需要注意的是：如果添加了多個參數(shù)，則只能通過「開發(fā)組裝」的方式來使用「自定義鏈接」。

2、開發(fā)POST參數(shù)

「開發(fā)POST參數(shù)」也需要貴方開發(fā)人員參與，通過POST的方式，將參數(shù)帶入。

POST地址：問卷的通用地址，可以在「鏈接與二維碼」頁面獲取；

數(shù)據(jù)格式：x-www-form-urlencoded；

參數(shù)帶入：以鍵值對形式帶入，參數(shù)名及參數(shù)值的計算同「鏈接傳參」一致。

3、手動填入

如果只使用一個參數(shù)，則可以在問卷星后臺手動批量生成帶參數(shù)的鏈接。如果是「sojumpparm」默認參數(shù)和「字符串」的參數(shù)，可以批量上傳一批參數(shù)值然后下載獲取對應的鏈接與二維碼。如果是「選擇類」參數(shù)，則無需上傳就可以直接批量導出帶參數(shù)的鏈接與二維碼。

關(guān)鍵參數(shù)

關(guān)鍵參數(shù)是用來控制「 每個關(guān)鍵參數(shù)值可作答次數(shù)」這個功能的，默認情況下是「sojumpparm」這個參數(shù)，添加多個參數(shù)后可以修改為其他的參數(shù)。

數(shù)據(jù)查詢

傳遞參數(shù)時帶入isquery參數(shù)就可以控制當前訪問是「作答」還是「查詢」，其中參數(shù)值為0時為作答問卷，參數(shù)值為1時為查詢答卷。isquery參數(shù)可以為空，為空時默認為作答問卷，isquery參數(shù)也不參與parmsign參數(shù)的簽名計算。

安全配置

1、「只允許從自定義鏈接訪問」，勾選后只能通過自定義鏈接參數(shù)作答，普通問卷鏈接會提示無法訪問。

2、「增加過期時間」，勾選后生成的自定義鏈接參數(shù)會增加一個過期時間戳字段（endts），超過后鏈接將失效。

3、「校驗參數(shù)簽名」，勾選后生成的自定義鏈接參數(shù)會增加一個簽名字段（parmsign），如果有人篡改參數(shù)值，鏈接將失效。

4、「提交后再次訪問可查詢作答記錄」，勾選后用戶在「沒有達到訪問次數(shù)」前可以正常訪問作答，在「達到訪問次數(shù)」后將直接進入答卷頁面。需要注意的是：這里的設(shè)置效果同「 每個關(guān)鍵參數(shù)值可作答次數(shù)」有強關(guān)聯(lián)。

DEMO

為了方便用戶進行開發(fā)調(diào)試，增加的任何參數(shù)或設(shè)置，均可以在「鏈接參數(shù)URL預覽」中體現(xiàn)，并且系統(tǒng)還提供了一個「DEMO」生成的功能，可以手動輸入?yún)?shù)進行調(diào)用測試。

回傳參數(shù)

帶入的參數(shù)，如果想回調(diào)到自己系統(tǒng)，可以在「設(shè)計問卷」》「問卷設(shè)置」》「提交后顯示」》「跳轉(zhuǎn)到指定頁面」中設(shè)置一個回調(diào)地址，并且按如下規(guī)則在回調(diào)地址中寫入之前帶入的參數(shù)。

默認「sojumpparm」參數(shù)的回調(diào)寫法{output}，需特別注意「sojumpparm」的回調(diào)寫法并非是{sojumpparm}，如果傳遞sojumpparm有進行簽名校驗，那在跳轉(zhuǎn)時也會帶上wjxsign的簽名參數(shù)以保證安全性。

q1參數(shù)的回調(diào)寫法為{q1}，其他序號題目依次類推。

在問卷頁面中顯示帶進來的參數(shù)

問卷頁面支持將默認的「sojumpparm」參數(shù)顯示在段落說明或題干中。插入方法：將[sojumpparm]這個字段輸入在段落說明或題干中，如下圖所示（顯示帶進來的參數(shù)僅限尊享版用戶使用）：

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

關(guān)于循環(huán)評價題的自定義鏈接參數(shù)設(shè)置

比如用戶在“循環(huán)評價題”中設(shè)置了20個被評價對象，但本次只需要用戶固定評價其中的5個，則可以使用自定義鏈接進行設(shè)置，參數(shù)配置為對應的題號和被評價對象序號，各個序號用逗號隔開即可：如：q2=1,2

用戶用配置了自定義鏈接參數(shù)作答，“循環(huán)評價題”中即可自動選中1、2個被評價對象，無需用戶再進行選擇

自定義鏈接參數(shù)API_舊版文檔