AppLink的结构
更新于 2024-01-22本文档介绍AppLink的结构和AppLink协议的能力。
AppLink协议就是一个URL协议。AppLink协议可以用于打开钉钉客户端或者其中的一个功能。
尝试一下：通过Applink打开钉钉创建群聊 https://applink.dingtalk.com/action/creategroup。
目前可通过Applink可打开的钉钉的功能 请参考已支持的协议。
AppLink协议的结构
字段 | 值 | 说明 |
scheme | https | 固定值。 |
host | applink.dingtalk.com | 固定值。 |
path | 对应不同的协议 |
|
query | 协议参数，不同的协议有不同的定义 | 例如：key1=value1&key2=value2 。 说明 所有参数key 和 value 都要进行encodeURIComponent。 |
AppLink协议的能力
在钉钉客户端内打开AppLink协议，则会直接跳转到钉钉中对应的功能。
在钉钉客户端外部（如浏览器内）打开Applink协议，会先打开如下网页，提示用户下载钉钉或单击打开钉钉对应的功能。
钉钉AppLink协议支持的版本情况
在钉钉客户端内使用AppLink时，如果当前钉钉版本低于要求的最小钉钉版本时，将打开Applink网页，提示版本过低，需要升级钉钉客户端版本后使用。
钉钉客户端 | IOS | Android | MacOS | Windows |
版本 | ≥6.5.45 | ≥6.5.45 | ≥6.5.50 | ≥6.5.50 |
钉钉AppLink支持以降级方式打开
AppLink协议是dingtalk:// (deeplink协议)的升级版本，如果当前钉钉版本低于协议支持的最低版本时，会默认降级到浏览器打开AppLink网页，并在AppLink网页里通过dingtalk://dingtalkclient/${path} 的方式尝试继续执行协议。
AppLink与dingtalk:// (deeplink协议)的path存在映射关系，大部分path保存一致，可参考已支持的dingtalk协议。
