打开小程序

本文档介绍使用AppLink协议打开钉钉小程序的相关说明。

使用场景

打开小程序或小程序中目标页面。

版本支持

钉钉客户端	Android	iOS	macOS	Windows
版本	≥6.5.45	≥6.5.45	≥7.0.40	≥7.0.40

协议

https://applink.dingtalk.com/action/open_mini_app

说明

如果要在PC端使用该协议打开钉钉小程序，在小程序发布时，必须选择支持移动端与PC端。否则PC端使用该协议打开的页面会是白屏。

字段说明

资源名+path定义	字段	必填	说明
action/open_mini_app	miniAppId	是	小程序miniAppId。企业内部应用，可参考基础概念-miniAppId。第三方企业应用，可参考基础概念-miniAppId。
appId	否	小程序appId。重要第三方企业小程序，该参数必传，可参考基础概念-appId。
type	是	小程序类型。1：三方企业应用2：企业内部应用4：第三方个人应用
page	否	访问小程序应用的具体某个页面的路径，不设置则打开首页，需要encode处理。例如：`%2Fpages%2Fmain%2Fmain`。
target	否	打开的容器类型：移动端：fullScreen（默认）：全屏容器打开panel：沉浸式容器打开说明什么是沉浸式容器，请参考沉浸式容器。桌面端：slide（默认），侧边栏打开panel：第四栏打开popupWindow：独立弹窗打开
mobileHeight	否	沉浸式容器的高度。semi：百分之50屏幕高度。说明该字段不填，则默认为百分之83的屏幕高度。
corpId	否	组织corpId。说明如果是企业内部小程序，该字段必填。
agentId	否	小程序应用的agentId。企业内部应用，可参考基础概念-agentId。第三方企业应用，可参考基础概念-agentId。说明如果是企业内部小程序，该字段必填。
pVersion	否	企业内部小程序应用必填，固定值为1。
packageType	否	企业内部小程序应用必填，固定值为1。

使用示例

使用全屏容器打开小程序

https://applink.dingtalk.com/action/open_mini_app?type=2&miniAppId=xxxxx&corpId=xxxxx&agentId=xxxxx&pVersion=1&packageType=1

使用沉浸式容器打开小程序

https://applink.dingtalk.com/action/open_mini_app?type=2&miniAppId=xxxxx&corpId=xxxxx&agentId=xxxxx&pVersion=1&packageType=1&target=panel

打开小程序中目标页面page/component/index

https://applink.dingtalk.com/action/open_mini_app?type=2&miniAppId=xxxxx&corpId=xxxxx&agentId=xxxxx&pVersion=1&packageType=1&page=page%2Fcomponent%2Findex

使用场景#

版本支持#

协议#

字段说明#

使用示例#

使用场景

版本支持

协议

字段说明

使用示例