紅包接口使用流程:登陸(搖搖啦平臺)注冊賬號
發(fā)紅包兩種方式,一種是你直接做好一個鏈接給用戶,他點了就領(lǐng)紅包掷匠,另一種是你在你的交互過程中嵌入靜默授權(quán)递礼,獲取到openid,然后隨時在后端可以發(fā)紅包盾计。
配置:
apikey:參數(shù)簽名密鑰售担,不超過32字節(jié)
對接ip:調(diào)用紅包創(chuàng)建接口的服務器IP,可寫多個署辉,用逗號分隔
1.紅包創(chuàng)建接口(單紅包)
https://www.yaoyaola.net/exapi/hbticket
參數(shù)說明(GET):
uid:(必填)客戶編號:系統(tǒng)分配(每個賬號唯一)
type:(必填) 紅包類型族铆,0使用紅包接口,1表示使用企業(yè)付款接口
如果使用企業(yè)付款哭尝,金額可以大于200元
企業(yè)付款的通知消息可自定義wishing哥攘,不顯示title和sendname
money:(必填)紅包金額,單位為分材鹦,不能低于30
orderid:(必填)自定義訂單號逝淹,不超過60字節(jié)
reqtick:(必填)請求時間戳,單位為秒桶唐,與北京標準時間誤差不能超過30秒
expire:紅包超時時間栅葡,單位為秒,不指定則默認60秒
sign:(必填)參數(shù)驗證簽名 md5(uid+type+orderid+money+reqtick+apikey)尤泽,共32字節(jié)欣簇,字母都為小寫
title:紅包活動名稱(不能超過10個漢字或32個字符)
sendname:紅包發(fā)送方名稱(不能超過10個漢字或32個字符)
wishing:紅包祝福語
rurl:紅包領(lǐng)取結(jié)果跳轉(zhuǎn)url,用于給用戶顯示客戶的自定義頁面安吁,通過GET方式傳送三個參數(shù)(以下三行為平臺傳給rurl的參數(shù)),如果rurl為空醉蚁,則跳轉(zhuǎn)至系統(tǒng)默認結(jié)果頁面
ticket: 紅包回執(zhí)
retmoney: 紅包領(lǐng)取金額,單位為分鬼店,0為領(lǐng)取失敗
retmsg: 返回信息
cburl:服務器通知url网棍,參數(shù)形式同rurl,用戶紅包領(lǐng)取成功時回調(diào)此url,失敗則不回調(diào)妇智,由客戶方在紅包超時后主動查詢確認結(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ā)財&sendname=千躍科技&wishing=心想事成";
$result = httpGet($url);
echo $result."\n";
請求示例:https://www.yaoyaola.net/exapi/hbticket?uid=1&type=0&orderid=657812195242&money=100&reqtick=1515133732&sign=7ad5e4da870203ed6c15bda5a60d06a4&title=恭喜發(fā)財&sendname=千躍科技&wishing=心想事成
返回結(jié)果:{"errcode":"0","errmsg":"success","ticket":"a06aba6515bbdb776f83fa74199bd3e9"}
2. 紅包領(lǐng)取接口(單紅包)
通過上面返回的ticket,拼裝出紅包領(lǐng)取鏈接:?https://www.yaoyaola.net/exapi/gethb/10000013?ticket=a06aba6515bbdb776f83fa74199bd3e9?,用戶點擊后巍棱,則立刻領(lǐng)取紅包惑畴,注意如果沒有指定超時時間,此鏈接有效時間默認為60秒.
如果要在小程序中打開領(lǐng)取航徙,需要做如下操作:
? ? ? ? ? ? ? ? 1. 在小程序后臺設(shè)置服務域名為www.yaoyaola.net
? ? ? ? ? ? ? ? 2. 聯(lián)系平臺將域名校驗文件上傳服務器
? ? ? ? ? ? ? ? 3. 將上面紅包鏈接協(xié)議頭http修改為https
3.授權(quán)跳轉(zhuǎn)接口
https://www.yaoyaola.net/exapi/check_user/
參數(shù)說明(GET):
url:獲取到openid后的跳轉(zhuǎn)url如贷,如果有帶參數(shù),可先對整個url做下urlencode編碼
flag:0表示靜默獲取openid,1表示需要用戶授權(quán)獲取詳細信息
示例: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:當前時間戳
u_openid:獲取到的用戶openid
encdata:簽名驗證信息杠袱,md5(apikey+openid+ivtick)
userinfo:flag=1時返回的用戶詳細信息尚猿,base64編碼
4.紅包直發(fā)接口
https://www.yaoyaola.net/exapi/SendRedPackToOpenid
參數(shù)說明(GET):
uid:客戶編號:1 (同上)
type:紅包類型,0使用紅包接口楣富,1表示使用企業(yè)付款接口
如果使用企業(yè)付款凿掂,金額可以大于200元
企業(yè)付款的通知消息只能顯示sendname,不能顯示活動名稱和祝福語
money:紅包金額纹蝴,單位為分庄萎,不能低于30
orderid:自定義訂單號
reqtick:請求時間戳
openid:用戶openid,可通過上面check_user接口獲取
sign:參數(shù)驗證簽名 md5(uid+type+orderid+money+reqtick+openid+apikey)
title:紅包活動名稱(不能超過10個漢字或32個字符)
sendname:紅包發(fā)送方名稱(不能超過10個漢字或32個字符)
wishing:紅包祝福語
示例:https://www.yaoyaola.net/exapi/SendRedPackToOpenid?uid=1&type=0&orderid=793174198142&money=50&reqtick=1547025439&openid=orsKq0c59kFgew2F2xfOWdRLQ-0M&sign=a8f2333cd13153702db9b7a9bafc5b2f&title=恭喜發(fā)財&sendname=千躍科技&wishing=心想事成
成功返回:{"errcode":"0","errmsg":"","ticket":"f07bb87429ef4f33b9de...","retmoney":"50","retmsg":"發(fā)放成功"}