API

API（Application Programming Interface，应用程序编程接口）是一套供不同程序、服务或计算机系统相互调用功能、交换数据的规则与接口。

概述

API可以理解为软件之间的“沟通窗口”。开发者不必了解另一套系统的全部内部实现，只需按照规定的参数、数据格式和调用方式发送请求，即可使用其开放的能力，例如获取天气信息、处理支付、调用地图或读取数据库。

API既可以指描述接口行为的规范，也可以指实现并提供该接口的软件。接口规范通常会说明可用功能、输入参数、返回结果、错误信息、身份验证方式和使用限制。提供接口常被称为“开放”或“暴露”API，使用接口则称为调用API。

主要特点

• 封装实现：隐藏内部代码和处理过程，仅向调用方提供必要功能。
• 统一约定：通过明确的请求方式和数据结构降低软件协作成本。
• 便于复用：同一项能力可以被网站、移动应用、桌面软件等多个客户端使用。
• 支持集成：帮助不同厂商、语言或平台开发的系统连接起来。
• 可控访问：服务方可通过密钥、令牌、权限和调用频率限制保护资源。

常见类型

常见API包括操作系统API、程序库API、硬件API和Web API。Web API通常通过网络提供服务，并采用HTTP等协议；REST是常见的设计风格，此外还有RPC、GraphQL等实现或查询方式。API本身并不等同于某一种协议，其具体形式取决于使用场景和接口规范。

常见问题

问：API和网站有什么区别？答：网站主要面向人展示和操作，API主要面向程序提供结构化数据或功能，但二者可以由同一服务同时提供。

问：调用API一定需要密钥吗？答：不一定。公开接口可能无需认证，涉及用户数据、付费能力或敏感操作的接口通常需要API密钥、令牌等凭证。

问：API是否等于REST API？答：不是。REST API只是Web API的一种常见形式，API还包括程序库接口、系统接口以及其他通信风格的接口。