抢先试用

 

 

 

 

 

 

https://qingflow.com/f/0e091896

功能介绍

借助Q-Linker，可获取任一开放api的系统中数据；

使用方法

开启Q-Linker:

• 获取Q-Linker使用权限：目前仅开放给Alpha版本及以上用户，如需试用可以联系我们~
• 在插件中心开启Q-Linker功能  
• 开启成功后，在表单设计中的高级字段中，会有Q-Linker字段 

配置Q-Linker设置

根据你想要获取的第三方系统的具体内容，编辑设置内容，具体Q-Linker配置设置介绍如下：

 

配置项名称	介绍	可填内容	补充描述
URL	第三方系统api的资源地址	URL;支持插入字段
Call Type	请求类型/方式	GET/POST
Header	请求所需提供给第三方系统的信息，当第三方系统要求提供这类信息时才需要设置	固定值
Body		固定值;支持插入字段
Result Format	第三方系统api返回内容的格式	JSON/XML/TEXT
Json Path	用于获取返回内容中的指定内容	仅返回内容的格式为JSON时，可填	详细介绍请看： https://github.com/json-path/JsonPath
XPath	用于获取返回内容中的指定内容	返回为XML时，可填	详细介绍请看：http://www.w3school.com.cn/xpath/index.asp
正则表达式	可用于获取返回内容中的指定内容	返回为TEXT时，可填	详细介绍请看：http://www.runoob.com/regexp/regexp-syntax.html

 

以一个有提供免费api的网站https://www.juhe.cn为例（该网站注册后，即提供免费api试用次数），你可根据下面的案例，在自取该网站的免费api后，尝试去调取该网站的其他数据~

 

晓希本人想要获取北京（cityname=1）现在的气温~所以申请了「全国天气预报」的api免费试用次数，并找到「全国天气预报」的api文档~

根据api文档，要想获取北京（cityname=1）现在的气温~我的Q-Linker配置设置如下：

 

 

 

 

 

 

 

 

 

 

设置到这个程度时，我们只能拿到该网站api文档中“JSON返回示例”一样的信息，但我想要今天的北京的实时温度就行了，即“JSON返回示例”中的temp部分~所以我们需要根据“JSON返回示例”设置一下Json Path~

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

这样我们的Q-Linker就设置完成了！

注意：当Q-Linker内容配置完毕后，必须点击保存，才是完全配置Q-Linker完毕哦~

设置关联

Q-Linker只是获取第三方系统的指定内容到轻流，如需调取使用，我们可以通过“数据关联”字段/或字段默认内容的“关联已有数据”，将数据关联过来。我们以“数据关联”为例，步骤如下：

1、在添加了“数据关联”后，在关联应用的下拉列表中，选择该Q-Linker字段

2、接着就可以在关联字段中选择之前在Result Format中设置被调取信息了~

接着刚刚“调取北京当前的气温”的例子，我们在“数据关联”这边设置的是这样的~

这样Q-Linker的使用就全部完成了！在“抢先试用”中的例子，就是我们今天一起做的“北京的实时气温”噢～

Json Path的常见配置

晓希还为你提供了下图几种常见的数据结构，以及对应的JSONPATH的配置方法：

注意事项

在轻流钉钉版使用Q-Linker前 ，需向轻流申请白名单，否则会影响功能的正常使用

更多案例

实时汇率换算（Q-Linker案例）

快递物流查询（Q-Linker案例）

身份证实名核验（Q-Linker案例）

空气质量查询（Q-Linker案例）