开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
基础 api
开放能力 api
支付
用户授权
会员
周期扣款
商家会员卡
消息
模板配置
支付宝卡包
交易组件
小程序商品
开发 > api > 开放能力 api > 模板配置 > my.getextconfig
评论
收藏
我的文档
设置

my.getextconfig(object object)

支小宝客户端 支持

安诊儿客户端 支持

主体: 企业支付宝小程序

相关文档: getextconfigsync

获取小程序模板自定义数据字段。

在模板小程序开发及实例化的过程中,ext 信息的传递路径如下:

模板小程序开发:

  • 1.1 服务商创建模板小程序并在本地开发,在项目根目录(与 app.json 同级)创建 ext.json 文件,最小示例内容:{"extenable":true,"ext":{"i":"am ok"}}
  • 1.2 服务端对模板小程序进行编码和调试,代码中调用 my.getextconfig/my.extconfigsync 获取 ext.json 中的 ext 字段内容作为小程序运行时个性化的配置项;
  • 1.3 服务商完成模板小程序开发,提交发布,支付宝审核通过。

模板小程序实例化:

  • 2.1 服务商调用 alipay.open.mini.version.upload 请求为特定商户创建模板小程序实例,传入的 ext 参数包含该商户特有的配置;
  • 2.2 支付宝应服务商请求创建小程序新实例或新版本,将请求的 ext 参数保存为 ext.json 文件,置入实例小程序的代码包,覆盖代码包中继承自模板的 ext.json 文件;
  • 2.3 小程序实例在客户端被加载运行,它包含与模板小程序一样的代码和个性化的 ext.json,运行时 my.getextconfig/my.getextconfigsync 读取此 ext.json 文件中的 ext 字段。

直到最后一步(即 2.3),小程序才能真正获取和使用最终的 ext 信息。这个较晚的时间点会带来一些调试方面的困难,发现相关代码问题往往需要模板小程序重新发布提审。 为了减少反复操作,建议在 1.2 中仔细设计和修改 ext.json,尽可能模拟真实情况并充分调试相关代码,在 2.1 构造真实 ext 内容时严格参照 1.2 中使用的 ext.json 格式。

object object

查看示例