什么是 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)记录
  • 版本化以保持向后兼容性

常见用途

  1. 第三方服务集成(支付、地图、社交)
  2. 移动应用后端通信
  3. 微服务架构
  4. 系统间数据交换
  5. 构建平台生态系统

示例

// 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'
  })
});

QubitTool 相关工具

相关概念