紅包接口使用流程:登陸(搖搖啦平臺(tái))注冊(cè)賬號(hào)
發(fā)紅包兩種方式狂丝,一種是你直接做好一個(gè)鏈接給用戶劳澄,他點(diǎn)了就領(lǐng)紅包皂林,另一種是你在你的交互過程中嵌入靜默授權(quán),獲取到openid乱凿,然后隨時(shí)在后端可以發(fā)紅包顽素。
配置:
apikey:參數(shù)簽名密鑰,不超過32字節(jié)
對(duì)接ip:調(diào)用紅包創(chuàng)建接口的服務(wù)器IP徒蟆,可寫多個(gè)胁出,用逗號(hào)分隔
1.紅包創(chuàng)建接口(單紅包)
https://www.yaoyaola.net/exapi/hbticket
參數(shù)說明(GET):
uid:(必填)客戶編號(hào):系統(tǒng)分配?(每個(gè)賬號(hào)唯一)
type:(必填) 紅包類型,0使用紅包接口后专,1表示使用企業(yè)付款接口
如果使用企業(yè)付款划鸽,金額可以大于200元
企業(yè)付款的通知消息可自定義wishing,不顯示title和sendname
money:(必填)紅包金額,單位為分裸诽,不能低于30
orderid:(必填)自定義訂單號(hào)嫂用,不超過60字節(jié)
reqtick:(必填)請(qǐng)求時(shí)間戳,單位為秒丈冬,與北京標(biāo)準(zhǔn)時(shí)間誤差不能超過30秒
expire:紅包超時(shí)時(shí)間嘱函,單位為秒,不指定則默認(rèn)60秒
sign:(必填)參數(shù)驗(yàn)證簽名 md5(uid+type+orderid+money+reqtick+apikey)埂蕊,共32字節(jié)往弓,字母都為小寫
title:紅包活動(dòng)名稱(不能超過10個(gè)漢字或32個(gè)字符)
sendname:紅包發(fā)送方名稱(不能超過10個(gè)漢字或32個(gè)字符)
wishing:紅包祝福語(yǔ)
rurl:紅包領(lǐng)取結(jié)果跳轉(zhuǎn)url,用于給用戶顯示客戶的自定義頁(yè)面蓄氧,通過GET方式傳送三個(gè)參數(shù)(以下三行為平臺(tái)傳給rurl的參數(shù)),如果rurl為空函似,則跳轉(zhuǎn)至系統(tǒng)默認(rèn)結(jié)果頁(yè)面
ticket: 紅包回執(zhí)
retmoney: 紅包領(lǐng)取金額,單位為分喉童,0為領(lǐng)取失敗
retmsg: 返回信息
cburl:服務(wù)器通知url撇寞,參數(shù)形式同rurl,用戶紅包領(lǐng)取成功時(shí)回調(diào)此url,失敗則不回調(diào)堂氯,由客戶方在紅包超時(shí)后主動(dòng)查詢確認(rèn)結(jié)果蔑担。
PHP示例代碼:$apikey = "xxxxxxxxxxxxx";
$uid = 1;
$type = 0;
$money = 50;
$orderid = rand(1000,9999).rand(1000,9999).rand(1000,9999);
$reqtick = time();
$signstr = $uid.$type.$orderid.$money.$reqtick.$apikey;
$sign = md5($signstr);
$url = "https://www.yaoyaola.net/exapi/hbticket?uid=".$uid."&type=".$type."&orderid=".$orderid."&money=".$money."&
reqtick=".$reqtick."&expire=3600&sign=".$sign."&title=恭喜發(fā)財(cái)&sendname=千躍科技&wishing=心想事成";
$result = httpGet($url);
echo $result."\n";
請(qǐng)求示例:https://www.yaoyaola.net/exapi/hbticket?uid=1&type=0&orderid=657812195242&money=100&reqtick=1515133732&sign=7ad5e4da870203ed6c15bda5a60d06a4&title=恭喜發(fā)財(cái)&sendname=千躍科技&wishing=心想事成
返回結(jié)果:{"errcode":"0","errmsg":"success","ticket":"a06aba6515bbdb776f83fa74199bd3e9"}
2. 紅包領(lǐng)取接口(單紅包)
通過上面返回的ticket,拼裝出紅包領(lǐng)取鏈接:?https://www.yaoyaola.net/exapi/gethb/10000013?ticket=a06aba6515bbdb776f83fa74199bd3e9?,用戶點(diǎn)擊后咽白,則立刻領(lǐng)取紅包啤握,注意如果沒有指定超時(shí)時(shí)間,此鏈接有效時(shí)間默認(rèn)為60秒.
如果要在小程序中打開領(lǐng)取晶框,需要做如下操作:
? ? ? ? ? ? ? ? 1. 在小程序后臺(tái)設(shè)置服務(wù)域名為www.yaoyaola.net
? ? ? ? ? ? ? ? 2. 聯(lián)系平臺(tái)將域名校驗(yàn)文件上傳服務(wù)器
? ? ? ? ? ? ? ? 3. 將上面紅包鏈接協(xié)議頭http修改為https
3.授權(quán)跳轉(zhuǎn)接口
https://www.yaoyaola.net/exapi/check_user/
參數(shù)說明(GET):
url:獲取到openid后的跳轉(zhuǎn)url排抬,如果有帶參數(shù),可先對(duì)整個(gè)url做下urlencode編碼
flag:0表示靜默獲取openid三妈,1表示需要用戶授權(quán)獲取詳細(xì)信息
示例:https://www.yaoyaola.net/exapi/check_user/10000013?url=https://www.yaoyaola.net/exapi/test.html&flag=0
跳轉(zhuǎn)ulr示例:
test.html?ivtick=1547025023&u_openid=orsKq0c59kFgew2F2xfOWdRLQ-0M&encdata=3aae5867b37028491062d6f34e592772&userinfo=
跳轉(zhuǎn)URL攜帶參數(shù)說明(GET):
ivtick:當(dāng)前時(shí)間戳
u_openid:獲取到的用戶openid
encdata:簽名驗(yàn)證信息畜埋,md5(apikey+openid+ivtick)
userinfo:flag=1時(shí)返回的用戶詳細(xì)信息,base64編碼
4.紅包直發(fā)接口
https://www.yaoyaola.net/exapi/SendRedPackToOpenid
參數(shù)說明(GET):
uid:客戶編號(hào):1 (同上)
type:紅包類型畴蒲,0使用紅包接口悠鞍,1表示使用企業(yè)付款接口
如果使用企業(yè)付款,金額可以大于200元
企業(yè)付款的通知消息只能顯示sendname模燥,不能顯示活動(dòng)名稱和祝福語(yǔ)
money:紅包金額咖祭,單位為分,不能低于30
orderid:自定義訂單號(hào)
reqtick:請(qǐng)求時(shí)間戳
openid:用戶openid蔫骂,可通過上面check_user接口獲取
sign:參數(shù)驗(yàn)證簽名 md5(uid+type+orderid+money+reqtick+openid+apikey)
title:紅包活動(dòng)名稱(不能超過10個(gè)漢字或32個(gè)字符)
sendname:紅包發(fā)送方名稱(不能超過10個(gè)漢字或32個(gè)字符)
wishing:紅包祝福語(yǔ)
示例:https://www.yaoyaola.net/exapi/SendRedPackToOpenid?uid=1&type=0&orderid=793174198142&money=50&reqtick=1547025439&openid=orsKq0c59kFgew2F2xfOWdRLQ-0M&sign=a8f2333cd13153702db9b7a9bafc5b2f&title=恭喜發(fā)財(cái)&sendname=千躍科技&wishing=心想事成
成功返回:{"errcode":"0","errmsg":"","ticket":"f07bb87429ef4f33b9de...","retmoney":"50","retmsg":"發(fā)放成功"}
失敗返回:{"errcode":"100021","errmsg":"透?jìng)魑⑿藕笈_(tái)返回的錯(cuò)誤信息"}