獎(jiǎng)勵(lì)營(yíng)銷活動(dòng) - API文檔

1.目的

無(wú)論是簽名還是微信登錄，都是為了加強(qiáng)安全性，防止被刷獎(jiǎng)，將被刷獎(jiǎng)的可能性降低。

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

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

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

3.用戶唯一性判定方式

同一活動(dòng)中，同一微信openid或簽名id 與手機(jī)號(hào)碼綁定，是一對(duì)一關(guān)系，同樣微信號(hào)或同樣簽名id算作一個(gè)用戶，手機(jī)號(hào)碼不可重復(fù)。

4.選擇建議

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

5.簽名應(yīng)用場(chǎng)景舉例

1）充值滿1000元擁有1次抽獎(jiǎng)機(jī)會(huì)；
2）實(shí)名驗(yàn)證之后擁有1次抽獎(jiǎng)機(jī)會(huì)；
3）綁定銀行卡之后才能擁有1次抽獎(jiǎng)機(jī)會(huì)；
4）用戶級(jí)別達(dá)到3級(jí)擁有1次抽獎(jiǎng)機(jī)會(huì)；
5）微信用戶是已關(guān)注了微信公眾號(hào)擁有1次抽獎(jiǎng)機(jī)會(huì)。

注意：
目前只提供1次抽獎(jiǎng)機(jī)會(huì)，若需要對(duì)同一用戶提供多次抽獎(jiǎng)機(jī)會(huì)，請(qǐng)與我們溝通。

6.簽名生成方式說(shuō)明

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

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

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

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

7.返回錯(cuò)誤碼

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

8.更多功能

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