# 打开小程序
从BOSSHI 3.2.0 版本开始支持。
# 使用场景
打开一个小程序或者小程序中的一个页面
# 协议
https://applink-bosshi.zhipin.com/client/applet/open?appId=123abc&openType=1&width=100&hight=100&reload=0&path=&pathAndroid=&pathIos=&pathPc=&minVersion=
1
# 参数
每一个参数都应当encode编码。
| 字段 | 必填 | 说明 |
|---|---|---|
appId | 是 | 小程序 appId(可从「开发者后台-凭证与基础信息」获取) |
openType | 否 | 仅对pc端有效 1.独立小窗打开 2.工作台中打开 3.独立大窗口打开 4.以侧边栏的形式打开 |
height | 否 | 仅针对PC独立大窗口打开有效，若小于小程序最小高度，会以最小高度打开 |
width | 否 | 仅针对PC独立大窗口打开有效，若小于小程序最小宽度，会以最小宽度打开 |
reload | 否 | 若当前页面已经打开且与目标页面路径相同 ∟ 当reload==0，仅打开不进行页面刷新，仅将小程序置顶 ∟ 当reload==1，刷新小程序页面并跳转到目标路径 若当前页面(无论是否打开)与目标页面路径不同，跳转到指定路径 （仅PC端支持） |
path | 否 | 需要跳转的页面路径，路径后可以带参数。也可以使用 path_android、path_ios、path_pc 参数对不同的客户端指定不同的path |
pathAndroid | 否 | 同 path 参数，Android 端会优先使用该参数，如果该参数不存在，则会使用 path 参数 |
pathIos | 否 | 同 path 参数，iOS 端会优先使用该参数，如果该参数不存在，则会使用 path 参数 |
pathPc | 否 | 同 path 参数，PC 端会优先使用该参数，如果该参数不存在，则会使用 path 参数 |
path参数值可以携带 Query 参数。比如：
path=pages%2Findex%3Ffoo%3Dbar
// 上述值decode以后是 pages/index?foo=bar
1
2
2
# 使用示例
# 1. 打开小程序 (请替换为实际链接)
https://applink-bosshi.zhipin.com/client/applet/open?appId=1234567890&openType=1
1
# 2. 打开小程序的一个页面 pages/home (请替换为实际链接)
https://applink-bosshi.zhipin.com/client/applet/open?appId=1234567890&openType=1&path=pages%2fhome
1
# 3. 打开小程序的一个页面带参数 pages/home?xid=123 (请替换为实际链接)
https://applink-bosshi.zhipin.com/client/applet/open?appId=1234567890&openType=1&path=pages%2fhome%3fxid%3d123
1
# 4. 在 PC 端打开页面 pages/pc_home?pid=123，在其他端打开页面 pages/home?xid=123 (请替换为实际链接)
https://applink-bosshi.zhipin.com/client/applet/open?appId=1234567890&openType=1&path=pages%2fhome%3fxid%3d123&pathPc=pages%2fpcHome%3fpid%3d123
1