一、接口功能應用場景
在問卷設置》跳轉設置》跳轉到指定頁面設置跳轉目標的URL,并且開啟“POST答卷數(shù)據(jù)到該地址”的功能。就可以實現(xiàn):填寫者在提交答卷后,跳轉到這個指定的URL頁面,并且系統(tǒng)會同步將該填寫者作答的數(shù)據(jù)POST到該URL頁面。
應用場景:在填寫者提交答卷后,可以跳轉到用戶自己的系統(tǒng)頁面,并且作答信息(通過接口獲取到的)作為頁面元素顯示在自己系統(tǒng)頁面。如:考試問卷如果不想使用問卷星提供的標準成績單,可以使用該功能,自己寫一個成績單頁面作為跳轉頁面。
二、頁面目標地址
使用頁面目標地址需要注意以下問題:
1、該地址需保證外網(wǎng)可訪問的狀態(tài);
2、該地址需要承載填寫者提交答卷后的跳轉落地頁,所以需保證合適的頁面內容;
3、數(shù)據(jù)將以表單的方式POST到該地址,需要增加開發(fā)代碼以讀取form表單數(shù)據(jù)的content內容。
三、POST答卷數(shù)據(jù)
POST答卷數(shù)據(jù)會將每個填寫者作答的數(shù)據(jù),在其點擊“提交”時推送到“頁面目標地址”。每個填寫者點擊提交,就會執(zhí)行一次推送操作;
1、推送機制
1) 用戶在問卷設置界面設置跳轉到指定頁面,并勾選“POST答卷數(shù)據(jù)到該地址”;
2) 如果需要獲取問卷內容,可同時勾選“POST問卷內容到該地址”。如果未顯示此選項,請聯(lián)系客服顧問開通權限;
3) POST答卷數(shù)據(jù)到跳轉的指定頁面的方式,與數(shù)據(jù)推送API方式只能二選一,推薦使用POST答卷數(shù)據(jù)到跳轉的指定頁面;這種方式的實時效性、穩(wěn)定性更強;
用戶在提交完答卷后,問卷星將直接跳轉到指定的頁面并將答卷數(shù)據(jù)放在POST消息體中;
跳轉到用戶指定頁面后,用戶指定頁面可以同時讀取到POST的內容;
2、數(shù)據(jù)加密
考慮到答卷數(shù)據(jù)傳輸?shù)陌踩?,推送的答卷?shù)據(jù)進行了AES加密,加密密鑰可以在設置界面獲取到;
解密方法如下:
1)讀取推送的BASE64數(shù)據(jù)為byte[] encryptedData;
2)取AES加解密密鑰作為AES解密的KEY
3) 取byte[] encryptedData的前16位做為IV;
4)取第16位后的字節(jié)數(shù)組做為待解密內容;
5)解密模式使用CBC(密碼塊鏈模式);
6)填充模式使用PKCS #7(填充字符串由一個字節(jié)序列組成,每個字節(jié)填充該字節(jié)序列的長度);
7)使用配置好的實例化AES對象執(zhí)行解密;
8)使用UTF-8的方式,讀取二進制數(shù)組得到原始數(shù)據(jù)
示例代碼(C#)
- //1)讀取推送的BASE64數(shù)據(jù)為byte[] encryptedData;
- byte[] encryptedData = Convert.FromBase64String(encrypted);
- if (encryptedData == null || encryptedData.Length < 17)
- return null;
- //2)取AES加解密密鑰作為AES解密的KEY;
- byte[] key = Encoding.UTF8.GetBytes(aesKey);
- //3) 取byte[] encryptedData的前16位做為IV;
- byte[] iv = encryptedData.Take(16).ToArray();
- //4)取第16位后的字節(jié)數(shù)組做為待解密內容;
- encryptedData = encryptedData.Skip(16).ToArray();
- using (var aes = new RijndaelManaged())
- {
- //5)解密模式使用CBC(密碼塊鏈模式);
- aes.Mode = CipherMode.CBC;
- //6)填充模式使用PKCS #7(填充字符串由一個字節(jié)序列組成,每個字節(jié)填充該字節(jié)序列的長度);
- aes.Padding = PaddingMode.PKCS7;
- aes.Key = key;
- aes.IV = iv;
-
- var cryptoTransform = aes.CreateDecryptor();
- //7)使用配置好的實例化AES對象執(zhí)行解密
- byte[] r = cryptoTransform.TransformFinalBlock(encryptedData, 0, encryptedData.Length);
- //8)使用UTF-8的方式,讀取二進制數(shù)組得到原始數(shù)據(jù)
- return Encoding.UTF8.GetString(r);
- }
3、推送內容及格式
1、推送內容存儲在表單(application/x-www-form-urlencoded)的content字段中;
2、content字段的值為經過aes加密后的base64字符串,解密后的內容包括答卷數(shù)據(jù)以及問卷數(shù)據(jù);
3、答卷數(shù)據(jù):推送內容及格式與數(shù)據(jù)推送API相同,參見:http://53918.cn/help/help.aspx?helpid=407&h=1
4、問卷數(shù)據(jù):推送內容及格式與問卷開放API[1000001]接口相同,詳細請咨詢客服顧問獲取文檔;
DEMO
1、demo地址:
http://53918.cn/demo/activityredirect.aspx?aes=822861f9c5114dc2bda214cd9567d0dc注:紅色部分為AES解密密鑰
2、示例代碼(C#):
- public partial class demo_activityredirect : System.Web.UI.Page
- {
- string aeskey = "";
- string content = string.Empty;
- protected void Page_Load(object sender, EventArgs e)
- {
- content = Request.Form["content"];
- aeskey = Request.QueryString["aes"];
- Response.Write("推送的加密內容[content]:" + Receive());
- Response.End();
- }
- //接收推送消息
- protected string Receive()
- {
- try
- {
- if (!string.IsNullOrEmpty(content) && !string.IsNullOrEmpty(aeskey))
- {
- content = Wjx.Common.Encrypt.Aes.Decrypt(content, aeskey);
- return content;
- }
- return "讀取內容為空";
- }
- catch (Exception e)
- {
- return "出錯啦!\r\n" + e.Message;
- }
- }
- }