尽管DreamFactory平台最出名的是生成REST api的能力,很多人也利用这个平台的远程服务连接器。
代理远程HTTP API
使用HTTP服务连接器代理第三方通过DreamFactory HTTP api。这开辟了一个全新的世界的可能性在创建复杂的由api驱动的应用程序方面,因为一旦安装您可以创建强大的工作流涉及多个api。一旦我们喜欢炫耀DreamFactory从MySQL数据库中检索记录的能力,然后把一些返回的文本翻译成不同的语言IBM华生的语言翻译API。你也可以轻松挂载任何的成千上万的api中发现的乐天RapidAPI市场。
在本节中,您将了解如何添加第三方OpenWeather API你DreamFactory实例。如果你想跟随这个例子中,去https://openweathermap.org/并创建一个免费帐户为了获得一个API键。
配置HTTP服务连接器
连接远程HTTP API DreamFactory很容易完成几个步骤。与所有DreamFactory服务一样,你首先登录DreamFactory实例,选择服务选项卡,并单击创建位于左边的菜单条的链接。从那里你会选择HTTP服务连接器位于远程服务类别:
接下来你将分配一个名称、标签和描述。回忆从先前的章节名称将会扮演一个角色作为生成的API的名称空间URI结构,因此您需要使用字母数字字符。我将使用这个名字openweather本教程的目的。标签和描述作为参考信息,可以指定任何你请。
接下来,单击配置选项卡。在这里你会告诉DreamFactory如何连接到远程服务:
最简单的解决方案涉及到远程API的基URL粘贴。根据当前的OpenWeather API文档您将使用URLhttps://api.openweathermap.org/data/2.5/weather作为基URL。
向下滚动到旁边参数部分并单击加号位于右侧的部分:
返回到OpenWeather网站和登录到你的账户,你会发现你的API键下的部分API密钥。这个API密钥的传递参数,这意味着你需要将它添加到参数部分如下所示:
参数名称是APPID,在(灰色的)价值价值字段。声明为参数出站因为我们要将它传递给API的目的地。这是形成鲜明对比排除选择这将防止从客户机传递特定的参数传递到目的地。你也可以选择通过选择缓存性能的关键原因缓存键选择。最后,我们宣布启用该参数的动词。在这种情况下,只有动词声明得到因为我们要的问题得到为了获取天气数据的请求。
后添加URL和基础APPID按下参数,保存您的更改保存按钮。
调用API
与服务到位,让我们打开HTTP测试工具如失眠或邮差来测试它。与所有DreamFactory api一样,你首先需要创建一个角色和API密匙。如果你不知道如何做到这一点遵循这些链接然后返回来继续的例子。
您将创建一个打电话给你服务得到请求指向https://YOUR_DREAMFACTORY_DOMAIN/api/v2/openweather传递参数与所需的地理目标联系在一起。你可以找到一个支持的参数列表OpenWeather API文档。请注意我们也走过的X-DreamFactory-Api-Key头。这个API的关键是以下随时被创建的前面提到的指令发现其他地方的指南。
在以下截图查询天气assocated 43016年与美国邮政编码:
因为这个请求被转发从DreamFactory OpenWeather API,出站请求是这样的:
https://api.openweathermap.org/data/2.5/weather?APPID= {YOUR_APP_ID}邮政= 43016,我们添加标题
诚然,OpenWeather API的做法需要API密匙被传递参数是有点奇怪,因为即使当使用HTTPS这些参数可以被第三方截获,另外可以记录到一个web服务器日志文件。相反,它的典型实践授权密钥通过一个头被传递。头是可取的,因为他们是加密的HTTPS使用时。
添加一个标题,点击加号位于右侧的头部分:
输入字段类似于这些发现参数头,一个明显的区别。你可以选择的从客户端选择通过头发出请求的客户机。这是有用的,如果你的客户正在与第三方服务DreamFactory实例,并且需要传递自己的自定义标题。例如,下面的屏幕截图展示了传递所需的乐天RapidAPI头X-RapidAPI-Host和X-RapidAPI-Key从客户端到DreamFactory:
这是标题是如何配置内部DreamFactory实现:
添加一个服务定义
节即将到来。
转换SOAP休息
视频学习
如果视频学习更符合你的风格,看看我们创建的Youtube视频~ 12分钟走你通过配置和访问过程:
