根据 API 提供者和 API 消费者所处的位置不同,我们可以把 API 分为两类:
- 本地 API:当 API 的提供者和消费者位于同一台计算机上时,称为为本地 API. 例如,操作系统提供的 Windows API;C 编译器提供的标准 C 库;OpenGL 提供的 2D、3D 图形 API;TensorFlow 提供的机器学习 API,等等。下面是本地 API 的一个例子,选自 TensorFlow 库的 Python 语言 API:
tf.io.FixedLenFeature(
shape, dtype, default_value=None
)
- 远程 API:当 API 的提供者和消费者位于不同的计算机上时,称为远程 API. API 提供者和 API 的消费者通过网络通信,进行交互。例如,一个气象服务提供公开的天气预报 API,允许第三方的应用软件访问,获得天气信息并展示给用户;微信提供的支付 API,第三方电商应用软件可以通过微信支付 API 进行收款,等等。下面是一个微信支付 API 的例子,源自微信支付接口文档,是典型的基于 HTTP 协议的 API:
https://api.mch.weixin.qq.com/v3/pay/transactions/jsapi
我们后面的学习的重点是基于 HTTP 协议的远程 API.