我们所有的 API 都依赖于VADL(Vtiger 应用程序定义语言),它基于 XML,允许您调用任何基于 HTTP 的端点。
我们需要定义 HTTP 端点的结构,通常涉及请求类型(例如 GET、POST、PUT、DELETE)、URL 端点、请求标头以及身份验证(例如基本身份验证)等。 为了从 openweathermap.org 访问某个城市的天气详情,他们定义了一个包含以下端点的 GET 请求。
我们需要将其映射到 VADL,它看起来像下面的示例:
00-04-07 的截图
让我一步一步解释这个过程:
任何放置在 rest 节点下的HTTP API都有一个强制方法属性,用于指定 HTTP 请求的类型(GET、POST 等)。
在其中,我们使用URL到达 API 端点。
注意,有些属性带有节点URL 。这些属性是端点的动态部分,用于在运行时用值替换它们。
任何具有动态值(以@为前缀)的属性在传递请求时都将被接受;我们在这里使用了@city。
对于 API 密钥,您可以粘贴来自 openweathermap 的值。对于任何属性,请确保在属性名称前添加$ ,以便在运行时替换它们。
URL 内部使用了CDATA部分。& 等特殊字符会被保留。
保存并发布后,您就可以像访问我们其他带有端点的 REST API 一样,从外部应用程序访问该 API。请查看下方 URL。我们使用 API 名称get_weather来调用该 API。您也可以从此处访问最终的 xml 文件。
重要的一点是,您应该在 API 设置中将任何 API 域列入白名单。
子图像-3
您也可以通过 Vtiger Javascript API 访问此 API,我们将向您展示如何操作。在 多米尼加共和国电报数据库 此之前,我们需要在详情页面上创建一个小部件来显示天气信息。
为此,我们将转到模块设计器,选择“联系人”,然后添加 TAP 脚本。
步骤 2:使用模块设计器添加新的天气小部件
在此步骤中,我们将
将小部件添加到详细信息页面
向小部件添加视觉元素 - 地图
添加弹出模型和管理设置
让我们开始吧。