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

什么是自定義鏈接

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

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

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

場(chǎng)景案例

使用要求

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

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

1、默認(rèn)參數(shù)

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

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

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

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

參數(shù)的代入

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

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

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

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

POST地址：?jiǎn)柧淼耐ㄓ玫刂?，可以在「鏈接與二維碼」頁面獲??；

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

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

3、手動(dòng)填入

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

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

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

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

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

安全配置

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

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

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

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

DEMO

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

回傳參數(shù)

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

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

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

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

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

示例：http://cgior.cn/jq/37943379.aspx?sojumpparm=張三

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

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

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

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