API是一个非常基础，但又常常被忽略、也常常有风险的东西。

不管你是在做AI工具、做自动化，还是想搭建自己的产品，都绕不开它。

---

API是什么？

定义

API = Application Programming Interface（应用程序编程接口）

听起来复杂，但你每天都在用它。

餐厅类比

角色	类比
你	客户端（发出请求的人）
服务员	API（中间桥梁）
厨房	服务器（真正处理的人）

你去餐厅吃饭，不需要进厨房，不需要知道怎么炒菜。

你只需要告诉服务员：“我要一份宫保鸡丁，不要辣。”

服务员把你的需求传递给厨房，厨房做好后端给你。

API就是这个服务员——定义你能点什么、怎么点、结果怎么返回。

---

一个真实的API请求长什么样？

调用OpenAI的API问"你好，今天天气怎么样"：

请求：
{
  "url": "https://api.openai.com/v1/chat/completions",
  "headers": {
    "Authorization": "Bearer 你的API Key"
  },
  "body": {
    "model": "gpt-4",
    "messages": [
      {"role": "user", "content": "你好，今天天气怎么样？"}
    ]
  }
}

返回：
{
  "choices": [
    {"message": {"content": "你好！我是一个AI助手，无法获取实时天气..."}}
  ]
}

就是一段有格式的请求：发去哪个地址、你的身份凭证是什么、你要说什么。

---

生活中的API例子

场景	API调用
天气App获取温度	调用气象局的API
地图导航规划路线	调用高德的API
用微信登录第三方App	调用微信授权API
AI写作工具	调用Claude或GPT的API

几乎所有你用到的软件和工具背后，都在用API做互相通信。

---

API能做什么？

场景1：自动化工作流

使用Zapier或Make：

步骤	动作
1	收到客户邮件
2	调用Gmail API读取内容
3	调用Notion API创建任务
4	调用Slack API发送通知

整个过程零人工，背后是三个API协同工作。

场景2：搭建自己的产品

想把AI能力嵌入自己的工具：

• 自己的客服系统
• 自己的笔记软件
• 自己的销售助手

几行代码就能拥有一个AI助手的核心能力。

场景3：数据获取和整合

需求	API解决方案
分析竞争对手定价	电商平台API自动获取
每天汇率更新	金融API自动拉取
监控社媒品牌关键词	社交平台API

不用手动复制，不用截图，直接进数据库。

---

API的两种主流形态

REST API

特点	说明
每个资源对应一个URL	清晰易懂
通过GET/POST/PUT/DELETE操作	标准方法
最主流	目前最常用

问题：获取用户名字和最近帖子，可能需要调两个接口，返回很多不需要的字段。

GraphQL

特点	说明
自定义需要的字段	精准获取
一次请求获取多个资源	高效

适合中大型项目，Facebook开发的方案。

---

API Key：绝对不能泄露

API Key是什么？

API Key就是你的身份证。

平台用它判断：

• 这个请求是谁发的
• 有没有权限
• 用了多少额度

泄露的后果

后果	说明
费用自己付	别人用你的Key产生的费用
数据被访问	不知道被谁访问了什么
账户清空	严重时账户被清空

常见泄露方式

方式	示例
代码开源没删Key	上传GitHub时忘记删除
截图发给朋友	Key被看到
公用电脑没退出	浏览器记住Key

安全建议

建议	说明
存在.env文件	不上传代码仓库
设置最小权限	只给必要的权限
定期轮换Key	定期重新生成
设置用量告警	发现异常及时处理

---

Rate Limit：为什么请求会失败？

什么是Rate Limit？

每个API服务都有速率和并发限制：

• 每分钟/每天最多调用几次
• 同时能调用几次

超了就会报错。

这不是Bug，是设计

平台需要：

• 防止滥用
• 保护服务器资源

实际开发的注意事项

注意点	说明
知道Limit是多少	清楚订阅的限制
做好重试机制	失败后重试
批量操作要排队	不要并发过多

---

Webhook：反向的API

区别

类型	模式
普通API	你主动问"有没有新订单"
Webhook	它主动告诉你"有新订单了"

应用场景

场景	Webhook用途
支付回调	付款成功后立刻通知
GitHub提交通知	有新提交时推送
自动化触发	事件发生时触发动作

更实时、更高效。

---

常见问题

Q1：API和SDK有什么区别？

API	SDK
接口规范	开发工具包
需要自己写调用代码	封装好了直接用

Q2：为什么有些API要收费？

服务器资源、维护成本、服务质量——免费通常有额度限制。

Q3：如何开始用API？

1. 找你想用的工具的API文档
2. 注册获取API Key
3. 发出你的第一个请求
4. 踩几个坑就懂了

---

一句话总结

API是应用之间通信的桥梁，就像服务员传递顾客的请求。

它能做自动化工作流、搭建AI产品、数据获取整合。

记住四点：REST和GraphQL的区别、API Key绝对不能泄露、Rate Limit是常规设计、Webhook是反向API。