什么是 API?
API(应用程序编程接口)是一组规则、协议和工具,允许不同的软件应用程序相互通信。它定义了软件组件应如何交互,使开发人员能够访问其他服务的功能或数据。
快速了解
| 全称 | 应用程序编程接口 |
|---|---|
| 创建时间 | 概念始于 1960 年代,现代 Web API 始于 2000 年代 |
| 规范文档 | 官方规范 |
API 工作原理
API 充当中介,允许应用程序相互通信,而无需了解另一个系统的内部工作原理。它们可以分为不同类型:Web API(REST、GraphQL、SOAP)、库 API、操作系统 API 和硬件 API。现代 Web 开发严重依赖 API 来集成第三方服务、访问数据库和构建微服务架构。API 通常使用 HTTP/HTTPS 进行通信,使用 JSON 或 XML 进行数据交换。
主要特点
- 定义软件通信的契约
- 抽象实现细节
- 实现不同系统之间的集成
- 可以是公共、私有或合作伙伴 API
- 通常使用规范(OpenAPI/Swagger)记录
- 版本化以保持向后兼容性
常见用途
- 第三方服务集成(支付、地图、社交)
- 移动应用后端通信
- 微服务架构
- 系统间数据交换
- 构建平台生态系统
示例
// REST API 请求示例
const response = await fetch('https://api.example.com/users/123', {
method: 'GET',
headers: {
'Authorization': 'Bearer token123',
'Content-Type': 'application/json'
}
});
const user = await response.json();
console.log(user);
// { id: 123, name: '张三', email: 'zhangsan@example.com' }
// POST 请求
const newUser = await fetch('https://api.example.com/users', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: '李四',
email: 'lisi@example.com'
})
});