半屏接入API使用須知
插件接入設置一、無法添加插件的解決方法
因官方調整,小程序無電信業務代理商類目無法添加插件,可使用半屏跳轉小程序的方式使用相關功能(半屏小程序專為插件對接使用,不會展示在微信下拉列表內,用戶無法通過搜索等方式打開,傳參跳轉后永久關聯用戶,無需擔心用戶以其他方式打開小程序)。
微信小程序管理后臺—設置—第三方設置—頁面最下方—半屏小程序管理—添加
二、流量卡半屏小程序appid為:wxa90429c57325c4c5
申請理由隨便填寫,自動通過申請。
跳轉時使用wx.openEmbeddedMiniProgram方法,路徑可參考下方接入文檔,只需傳參apikey和uid,微信文檔 例: wx.openEmbeddedMiniProgram({
appId: 'wxa90429c57325c4c5',
path: ',主頁路徑:pages/index/index?apikey=螞蟻星球apikey&uid=1'
path: ',子頁路徑:pages/detail/index?id=商品id&apikey=螞蟻星球apikey&uid=1'
})
三、充值、點餐、影票、團購優惠半屏小程序appid為:wx5f482af87ff127ca
申請理由隨便填寫,自動通過申請。
跳轉時使用wx.openEmbeddedMiniProgram方法,路徑可參考下方接入文檔,只需傳參apikey和uid,微信文檔 例: wx.openEmbeddedMiniProgram({
appId: 'wx5f482af87ff127ca',
path: 'pages/recharge/detail?cid=1&apikey=螞蟻星球apikey&uid=1'
})
四、小程序頁面路徑,以下頁面path可以通過半屏小程序(appid:wx5f482af87ff127ca)傳參打開
1、美團到店頁面:plugin-private://wx8b412290993bf26a/pages/index/index?apikey=螞蟻星球apikey&uid=216&index=/pages/index/index
2、美團超值券包頁面:plugin-private://wx8b412290993bf26a/pages/coupon/index?apikey=螞蟻星球apikey&uid=216&index=/pages/index/index
3、充值頁面:pages/recharge/recharge?apikey=螞蟻星球apikey&uid=1
4、充值單類目頁面:pages/recharge/detail?cid=商品分類ID
支持參數:
apikey:螞蟻星球的Apikey(不可為空)
uid:會員ID(不可為空,例:123)
index:小程序主頁路徑(例:/pages/index/index)
分享時,將自動分享主頁路徑,回傳參數from_id為會員ID,可根據此參數判斷分享者
單類目參數:
cid=商品分類ID(商品分類ID在螞蟻星球螞蟻星球推廣中心 推廣管理->利潤設置查看)
常用商品分類ID: 1 移動話費快充,2 移動話費慢充,3 聯通話費快充,4 聯通話費慢充,5 電信話費快充,6 電信話費慢充,8 電費充值,12 南網電費
5、充值、點餐聚合頁(ios部分類目不展示):pages/recharge/index(如需隱藏點餐類目,傳參dchide=1)
6、點餐平臺頁面:plugin://mayi-ordering/welcome?type=bsk&apikey=螞蟻星球apikey&uid=216&index=/pages/index/index
支持參數:
apikey:螞蟻星球的Apikey(不可為空)
uid:會員ID(不可為空,例:123)
index:小程序主頁路徑(例:/pages/index/index)
type:對應平臺,可選項(肯德基:kfc,麥當勞:mdl,奈雪:nx,星巴克:xbk,必勝客:bsk,庫迪咖啡:kd,瑞幸咖啡:rx)
old:可空,當傳值為1時,聚合頁只顯示插件內的六大平臺
theme:可空,當傳值為1時,切換不同的聚合頁風格
wm:可空,當傳值為1時,顯示外賣功能
skip:可空,當傳值為1時,外賣功能跳轉至單獨的外賣插件(需要引用點單助手插件:https://mp.weixin.qq.com/wxopen/plugindevdoc?appid=wx5f482af87ff127ca)
分享時,將自動分享主頁路徑,回傳參數from_id為會員ID,可根據此參數判斷分享者
7、影票頁面:plugin://mayi-movie/index?movieuid=666&movieapikey=螞蟻星球apikey&homepath=/pages/home/home&index=/pages/home/home(當會員中心頁面要使用switch時,增加參數&isswitch=1
支持參數:
movieuid:用戶ID(非必要)
movieapikey: APIKEY(字母或數字,必要)
index: 小程序主頁路徑(非必要)
homepath: 小程序會員中心路徑(非必要)
moviekefu: 小程序客服頁面路徑(非必要)
movieappid: wxd9eb35261efee8d9,跳轉其他小程序支付時需要
8、H5 本地生活頁面半屏小程序接入
小程序路徑:pages/web/index?apikey=螞蟻星球apikey&uid=1&type=1
參數說明:
apikey:螞蟻星球key
uid:1
移動積分兌換: pages/web/index?apikey=螞蟻星球apikey&uid=1&type=card
華萊士點餐H5: pages/web/index?apikey=螞蟻星球apikey&uid=1&type=1
鮮花快遞H5: pages/web/index?apikey=螞蟻星球apikey&uid=1&type=2
吃喝玩樂聚合H5: pages/web/index?apikey=螞蟻星球apikey&uid=1&type=5
漢堡王H5:pages/web/index?apikey=螞蟻星球apikey&uid=1&type=7
百果園H5: pages/web/index?apikey=螞蟻星球apikey&uid=1&type=8
喜茶點餐H5:pages/web/index?apikey=螞蟻星球apikey&uid=1&type=10
周邊特惠H5: pages/web/index?apikey=螞蟻星球apikey&uid=1&type=14
比價寄H5:pages/web/index?apikey=螞蟻星球apikey&uid=1&type=15
德克士H5:pages/web/index?apikey=螞蟻星球apikey&uid=1&type=16
示例代碼: