自定義鏈接參數API

什么是自定義鏈接

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

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

如果想做全局的配置，開(kāi)發(fā)一次每個(gè)問(wèn)卷都可以攜帶共同的一組參數，可以點(diǎn)擊此處了解。

場(chǎng)景案例

使用要求

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

默認參數和添加題目參數

1、默認參數

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

2、添加題目參數

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

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

參數的代入

1、開(kāi)發(fā)組裝鏈接參數

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

2、開(kāi)發(fā)POST參數

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

POST地址：?jiǎn)?wèn)卷的通用地址，可以在「鏈接與二維碼」頁(yè)面獲??；

數據格式：x-www-form-urlencoded；

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

3、手動(dòng)填入

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

關(guān)鍵參數

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

數據查詢(xún)

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

安全配置

1、「只允許從自定義鏈接訪(fǎng)問(wèn)」，勾選后只能通過(guò)自定義鏈接參數作答，普通問(wèn)卷鏈接會(huì )提示無(wú)法訪(fǎng)問(wèn)。

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

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

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

DEMO

為了方便用戶(hù)進(jìn)行開(kāi)發(fā)調試，增加的任何參數或設置，均可以在「鏈接參數URL預覽」中體現，并且系統還提供了一個(gè)「DEMO」生成的功能，可以手動(dòng)輸入參數進(jìn)行調用測試。

回傳參數

帶入的參數，如果想回調到自己系統，可以在「設計問(wèn)卷」》「問(wèn)卷設置」》「提交后顯示」》「跳轉到指定頁(yè)面」中設置一個(gè)回調地址，并且按如下規則在回調地址中寫(xiě)入之前帶入的參數。

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

q1參數的回調寫(xiě)法為{q1}，其他序號題目依次類(lèi)推。

在問(wèn)卷頁(yè)面中顯示帶進(jìn)來(lái)的參數

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

示例：http://nt-resale.com/jq/37943379.aspx?sojumpparm=張三

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

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

用戶(hù)用配置了自定義鏈接參數作答，“循環(huán)評價(jià)題”中即可自動(dòng)選中1、2個(gè)被評價(jià)對象，無(wú)需用戶(hù)再進(jìn)行選擇

自定義鏈接參數API_舊版文檔