web API分类

什么是Web API？

Web API是网络应用程序接口。包含了广泛的功能，网络应用通过API接口，可以实现存储服务、消息服务、计算服务等能力，利用这些能力可以进行开发出强大功能的web应用。

分类

一、请求--响应API。

请求--响应类的API的典型做法是，通过基于HTTP的Web服务器暴露一个/套接口。API定义一些端点，客户端发送数据的请求到这些端点，Web服务器处理这些请求，然后返回响应。响应的格式通常是JSON或XML。

在这种类型的Web API里，比较流行的是这三种： REST ， RPC 和 GraphQL 。

1.1 REST

REST全称是Representational State Transfer 表述性状态传递。REST可能是现在最流行的一种Web API。

REST的核心就是 资源 ，一个资源就是可以被标识的实体，它有名称和地址。

REST API就是把数据以资源的形式暴露出来，并使用标准的HTTP方法来代表创建、读取、更新和删除资源等事务。

1.2 RPC

Remote Procedure Call。RPC是一种比较简单的API，客户端直接会执行另一个服务器上的代码。

REST是关于资源的，而RPC就是关于动作的。

在RPC里，客户端通常是把方法名和参数传递给服务器，然后服务器返回JSON或XML。

1.3 GraphQL

GraphQL 是 API的查询语言。最近越来越火。它由Facebook于2012年开始开发，2015年被开源了。

二、事件驱动式 Web API

针对用请求-响应式API，如果服务的数据经常变化，那么响应就可能无法保持新鲜了。开发者如果想与变化的数据保持同步，就只能对API进行polling操作了。

但是如果poll的频率较低，客户端仍有可能无法获得从上次poll到现在所有的数据事件。如果poll的频率较高，还特别浪费资源。

所以我们需要实时的分享事件的数据，通常使用下面三种机制： WebHook ， WebSocket ， HTTP Streaming 。

2.1 WebHooks

WebHook就是一个接收HTTP POST（或GET，PUT，DELETE）的URL。一个实现了WebHook的API提供商就是在当事件发生的时候会向这个配置好的URL发送一条信息。与请求-响应式不同，使用WebHook，你可以实时接受到变化。

2.2 WebSocket

WebSocket这个协议，它通过一个TCP协议建立一个双向全双工的流式通信。WebSocket通常用在客户端和服务器之间的通信，也可以用在服务器之间的通信。

2.3 HTTP Streaming

使用请求-响应式API，客户端发送一个请求，服务器端返回一个响应，这个响应的长度是有限的。

而使用HTTP Streaming，服务器端可以在一个由客户端打开的长生存的连接里持续的推送新数据。