统一跳转协议说明 - 《Development Guide》

移动端
Windows 端

移动端

打开 App 内的 H5 应用

url 参数为 H5 应用的在线 url，例如：

import openLink from 'gdt-jsapi/openLink'
openLink({
    url: "https://www.dg-work.cn/home/"
}).then(res => {
    console.log(res)
})

打开 App 内的小程序/微应用

url 参数为专有钉钉开放平台小程序的 scheme 的 url

格式为：
taurus://taurusclient/action/open_app?appId={appId}&type={type}&offline={true/false}&page=&query=

字段规则为：

字段名	是否必填	含义
taurus://taurusclient	是	政务钉钉 App 在开放平台上对应的 scheme 和 host，以后不同的专有版会不一样
appId	是	小程序/微应用在开放平台注册的 appId
type	是	1: H5微应用，2: 小程序
offline	否	是否是离线包（仅针对于支持离线包的微应用）
page	否	小程序的页面路由，/x/y/z，需要进行 urlencode
query	否	小程序页面需要的参数，k1=v1&k2=v2，需要进行 urlencode

注意：
如果 type=1，即 H5 微应用，只能使用离线包 + appId
如果 type=2，即小程序，则只能使用 appId

例如：

import openLink from 'gdt-jsapi/openLink'
openLink({
    url:"taurus://taurusclient/action/open_app?appId=1111111111111111&type=2&offline="
}).then(res => {
    console.log(res)
})

跳转到外部 App

url 参数为外部 App 的 scheme 的 url，例如：

import openLink from 'gdt-jsapi/openLink'
openLink({
    url: "taobao://item.taobao.com/item.html?id=624886139695"
}).then(res => {
    console.log(res)
})

受专有钉钉安全管控，目标 App 的 scheme 需要在配置中心上配置才允许跳转。
配置路径：应用详情-应用权限-数据权限
应用的数据权限中配置三方app的scheme协议，配置到//即可，例如：xxxx://

Windows 端

打开一个外部链接

url 参数为 H5 的在线 url，分两种：

在浏览器里打开 url

import openLink from 'gdt-jsapi/openLink'
openLink({
  url:'https://www.dg-work.cn/home/'
}).then(res => {
    console.log(res)
})

在工作台打开

import openLink from 'gdt-jsapi/openLink'
openLink({
  url:'https://www.dg-work.cn/home/?ddtab=true'
}).then(res => {
    console.log(res)
})

打开内部一个目标地址，暂不支持

打开个人profile页

HTML页面填写专有钉钉PC端指定链接，当用户点击链接时，唤起PC客户端，并执行相应操作。
如打开个人profile页链接：

<a href="taurus://taurusclient/action/user/profile?staff_id={uid}"></a>
//uid为专有钉钉用户accountId