FastWeb-Webhook
# FastWeb-Webhook
Webhook 是一个 API 概念,是微服务 API 的使用范式之一,也被成为反向 API,即前端不主动发送请求,完全由后端推送;举个常用例子,比如你的好友发了一条朋友圈,后端将这条消息推送给所有其他好友的客户端,就是 Webhook 的典型场景。
简单来说,Webhook 就是一个接收 HTTP POST(或GET,PUT,DELETE)的URL,一个实现了 Webhook 的 API 提供商就是在当事件发生的时候会向这个配置好的 URL 发送一条信息,与请求-响应式不同,使用 Webhook 你可以实时接受到变化。
这又是一种对 客户机-服务器 模式的逆转,在传统方法中,客户端从服务器请求数据,然后服务器提供给客户端数据(客户端是在拉数据),在 Webhook 范式下,服务器更新所需提供的资源,然后自动将其作为更新发送到客户端(服务器是在推数据),客户端不是请求者,而是被动接收方;这种控制关系的反转可以用来促进许多原本需要在远程服务器上进行更复杂的请求和不断的轮询的通信请求;通过简单地接收资源而不是直接发送请求,我们可以更新远程代码库,轻松地分配资源,甚至将其集成到现有系统中来根据 API 的需要来更新端点和相关数据。
FastWeb的RestAPI默认的情况下需要token
才可以使用其中的功能,如果要使用Webhook
的相关功能,可参考以下方式来进行创建。
点击菜单栏系统工具
-接口开发(API)
,打开界面,点击[添加]
按钮,在添加界面中设置信息,注意公开接口
处需设置为True
。点击[保存]
。

选择此项,点击[接口开发]
,设置以下程序信息:
(*说明**********************
1.ToKenPerms >> 令牌权限列表
2.URLParams >> URL参数
3.UserInfos >> 令牌用户信息
4.PostStream >> 推送流
5.GetNodeDataLink(Const ANodeName:String):TFDConnection >> 获取节点数据库连接
***************************)
//Fixed format
Function RestAPI:String;
Begin
Result := 'OK';
End;
Begin
End.
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
关于RestAPI的用法可参考API调用说明。
点击[系统工具]
-[接口整合(Server)]
,打开接口整合
界面,输入API供应商以及API服务器的地址,填写相关说明,点击[保存]
。
点击[系统工具]
-[接口整合(API)]
,打开接口整合(API)
界面,点击[添加]
按钮,打开添加API
界面,在其中输入API的信息。
API名称与API描述部分可自行设置。

API供应商
处选择刚才创建的API供应商。
上文的API说明中已指出使用的Content-Type
以及请求方法
,此处按照说明中提供的内容选择。
参数部分填写如上图所示。
保存后,点击[保存]
按钮,返回管理页面。
找到刚才创建的API,点击[API测试],打开API管理器界面,在当前界面下,点击[send]按钮,观察Rest Server answer处显示的内容,如果显示的内容为下图样式的,则设置完成。
