Webhook入门教程：Webhook vs API 它们之间有什么区别？

Webhook入门教程

英文原文：https://sendgrid.com/blog/webhook-vs-api-whats-difference/

SendGrid团队2014年5月15日•3分钟阅读

当您熟悉SendGrid的服务甚至许多Internet公司的服务时，您会发现“ API”一词的使用非常广泛。您可能还会越来越多地看到有人提到“网络挂钩”。

在SendGrid，我们有意识地在文档中对两者进行了区分，并且无论何时我们编写或谈论有关简化电子邮件的七项服务。这是我们分解Webhooks和API之间差异的方法。

API代表应用程序编程接口，但这实际上意味着什么？与其说是什么，不如说我更容易谈论API支持什么。API可以共享数据或功能。例如，您可以使用places API按位置或名称查找餐厅，从而提取有关每个位置的大量数据。然后，您可以将其与映射API结合使用，将其用作显示数据的接口。

向API发出请求的程序员将收到响应。例如，使用我们的Web API发送电子邮件，您将在请求中传递电子邮件内容。如果一切顺利，您将收到一封声明成功的回复。

有时人们将webhooks称为反向API，但更准确地说，webhook可让您跳过一步。对于大多数API，在请求之后是响应。Webhook不需要任何请求，它仅在可用时发送数据。

要使用Webhook，请向提供服务的公司注册URL。该URL是应用程序中的一个位置，它将接受数据并对其进行处理。在某些情况下，您可以在希望接收数据时告知提供商情况。每当有新东西出现时，网络挂钩都会将其发送到您的URL。

棒球经理可以真正使用网络挂钩。随着比赛的进行，他们经常想更换投手。要做到这一点，需要新投手首先在牛棚中进行预热，牛棚通常距离团队的棚户区300英尺。如果您在电视上看棒球，经常会看到经理在掩护处接电话。他正在打电话给牛棚检查新的投手。

然后他挂断电话。几分钟后，他将不得不再次致电。程序员会称这种轮询为双方，这是过程密集型的。一个网络挂钩让您说，“他热身时给我打电话。”

SendGrid有两个与电子邮件流向有关的不同的Webhooks：

一些非SendGrid的Webhooks：

希望您能对Webhook是什么以及它与API有何不同提供一些想法。

现在是时候开始对那些Webhooks进行操作了。您可以使用webhooks进行以下四项操作，包括在本地计算机上对其进行测试或将其连接到其他服务。

Webhook是一个API概念，并且变得越来越流行。我们能用事件描述的事物越多，webhook的作用范围也就越大。Webhook作为一个轻量的事件处理应用，正变得越来越有用。

准确的说webhoo是一种web回调或者http的push API，是向APP或者其他应用提供实时信息的一种方式。Webhook在数据产生时立即发送数据，也就是你能实时收到数据。这一种不同于典型的API，需要用了实时性需要足够快的轮询。这无论是对生产还是对消费者都是高效的，唯一的缺点是初始建立困难。

Webhook有时也被称为反向API，因为他提供了API规则，你需要设计要使用的API。Webhook将向你的应用发起http请求，典型的是post请求，应用程序由请求驱动。

消费一个webhook是为webhook准备一个URL，用于webhook发送请求。这些通常由后台页面和或者API完成。这就意味你的应用要设置一个通过公网可以访问的URL。

多数webhook以两种数据格式发布数据：JSON或者XML，这需要解释。另一种数据格式是application/x-www-form-urlencoded or multipart/form-data。这两种方式都很容易解析，并且多数的Web应用架构都可以做这部分工作。

调试webhook有时很复杂，因为webhook原则来说是异步的。你首先要解发他，然后等待，接着检查是否有响应。这是枯燥并且相当低效。幸运的是还有其他方法：

1、明白webhook能提供什么，使用如RequestBin之类的工具收集webhook的请求；

2、用cURL或者Postman来模拟请求；

3、用ngrok这样的工具测试你的代码；

4、用Runscope工具来查看整个流程。

因为webhook发送数据到应用上公开的URL，这就给其他人找到这个URL并且发送错误数据的机会。你可采用技术手段，防止这样的事情发生。最简单的方法是采用https（TLS connection）。除了使用https外，还可以采用以下的方法进一步提高安全性：

1、首先增加Token，这个大多数webhook都支持；

2、增加认证；

3、数据签名。

当作为webhook的消费者时有两件事需要铭记于心：

1、webhook通过请求发送数据到你的应用后，就不再关注这些数据。也就是说如果你的应用存在问题，数据会丢失。许多webhook会处理回应，如果程序出现错误会重传数据。如果你的应用处理这个请求并且依然返回一个错误，你的应用就会收到重复数据。

2、webhook会发出大量的请求，这样会造成你的应用阻塞。确保你的应用能处理这些请求。