半屏接入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

示例代码:

联系技术支持:712218340 点击链接加入群聊【官方API交流群】(验证语:蚂蚁星球开放平台)