獎勵營銷活動 - API文檔

1.目的

無論是簽名還是微信登錄，都是為了加強安全性，防止被刷獎，將被刷獎的可能性降低。

2.兩種方式區(qū)別

微信登錄：當應用或系統(tǒng)限定于微信內(nèi)使用則可以選擇微信登錄，這也是最為常見的方式，通常不需要開發(fā)即可使用。

簽名登錄：當應用想要更強的兼容性或限定于APP內(nèi)，PC端，不止在微信內(nèi)使用則可以選擇此登錄方式，當然也可以在微信內(nèi)使用。簽名生成代碼工作量非常少，通常10行以內(nèi)代碼即可搞定。

3.用戶唯一性判定方式

同一活動中，同一微信openid或簽名id 與手機號碼綁定，是一對一關系，同樣微信號或同樣簽名id算作一個用戶，手機號碼不可重復。

4.選擇建議

1）微信是個非常好的傳播渠道，沒有特別需要，直接使用此方式會更便捷和快速以及更好傳播（可以不需要開發(fā)）；
2）關注微信公眾號之類的活動，首選微信登錄；
3）APP內(nèi)活動則可以使用簽名登錄；
4）PC端站點活動首選簽名登錄；
5）確保用戶必須滿足一定的資格才能參與活動則可以選擇簽名登錄。

5.簽名應用場景舉例

1）充值滿1000元擁有1次抽獎機會；
2）實名驗證之后擁有1次抽獎機會；
3）綁定銀行卡之后才能擁有1次抽獎機會；
4）用戶級別達到3級擁有1次抽獎機會；
5）微信用戶是已關注了微信公眾號擁有1次抽獎機會。

注意：
目前只提供1次抽獎機會，若需要對同一用戶提供多次抽獎機會，請與我們溝通。

6.簽名生成方式說明

傳遞參數(shù):
id:標識id
nonce:隨機數(shù)
timestamp:時間戳（數(shù)值型，允許 10 分鐘 統(tǒng)一以東 8 時間，格式如：1420045261）
sign:簽名

加密方式：對參數(shù)按照key=value的格式，并按照參數(shù)名ASCII字典序排序并拼接項目密鑰。

$string = "id=$id&nonce=$nonce&secret=密鑰×tamp=$timestamp";
$sign=sha1($string);

假設領取流量(劵)地址為:http://flow.216612.com/hd/56a21421044aa8f62c1c50dd
則傳遞如: http://flow.216612.com/hd/56a21421044aa8f62c1c50dd?id=testid&nonce=testnonce×tamp=testtimestamp&sign=testsign

7.返回錯誤碼

1001:缺少關鍵參數(shù)如:id nonce timestamp sign
1002:簽名過期,目前為10分鐘
1003:簽名驗證錯誤

8.更多功能

當傳遞參數(shù)cid時，若選擇『流量券』方式，則任務鏈接會自動加上傳遞的參數(shù)
假設任務地址為：http://www.baidu.com 則會更改為:http://www.baidu.com?cid=xxx
假設任務地址為：http://www.baidu.com?test=1 則會更改為:http://www.baidu.com?test=1&cid=xxx
假設需要自定義回傳參數(shù)名稱可如此：http://www.baidu.com?cid= 系統(tǒng)會自動補全為:http://www.baidu.com?cid= xxx