跳至正文

API是什么？ 🤔

当你开始学习编程时，经常会听到"API"这个词。但是准确理解API是什么可能很难。在这个指南中，我将非常简单地解释API！

用日常生活比喻API？​

让我们把API比作餐厅。

餐厅的故事 🍽️​

当你去餐厅时：

  1. 顾客（你）：想点餐
  2. 服务员：接收顾客的订单并传达给厨房
  3. 厨房：制作菜肴
  4. 服务员：把完成的菜肴送给顾客

在这里，服务员正是扮演API的角色！

顾客(应用) → 服务员(API) → 厨房(服务器)
                ↓
顾客(应用) ← 服务员(API) ← 完成的菜肴(数据)

API的正式定义​

API (Application Programming Interface)

它扮演桥梁的角色，使程序之间能够对话和交换信息。

通过实际例子理解​

例1：天气应用 ☀️​

打开天气应用时，会显示今天的天气：

1. 天气应用向天气服务器请求"告诉我今天首尔的天气！"
2. API传达这个请求
3. 服务器查找天气信息
4. API接收信息并传达给应用
5. 应用屏幕显示"首尔，晴，23°C"

例2：登录 🔐​

用Google账号登录其他网站时：

1. 网站向Google请求"验证这个人"
2. Google API确认用户信息
3. 确认后向网站回复"OK"
4. 登录完成！

例3：地图应用 🗺️​

为什么配送应用能看到地图：

配送应用不直接制作地图，
而是使用Google地图API获取地图！

API请求是什么样的？​

向API请求类似于输入地址：

https://api.weather.com/weather?city=Seoul
              ↑              ↑         ↑
         服务器地址      想要什么？   哪里的？

API的优点 🌟​

1. 不需要重新发明轮子​

可以通过API使用已经制作好的功能。

例子：

  • 支付功能：使用Stripe API
  • 地图功能：使用Google地图API
  • 登录功能：使用Google/Facebook登录API

2. 可以安全地交换信息​

因为不直接访问数据库，只通过API访问，所以很安全。

3. 多个程序可以一起使用​

智能手机应用、网站、平板应用都可以使用同一个API。

Web API的种类​

REST API（最常见）​

这是Web上最常用的API方式。

特点：

  • 通过URL请求
  • 简单易学
  • 大多数Web服务都使用

例子：

获取(读取):  GET https://api.example.com/users
创建(写入):  POST https://api.example.com/users
修改:       PUT https://api.example.com/users/123
删除:       DELETE https://api.example.com/users/123

GraphQL​

可以准确请求所需数据的方式。

SOAP​

旧式API。现在不太常用。

使用API试试​

你可以用我们网站的API Tester工具尝试使用真实的API！

简单练习​

  1. 前往API Tester
  2. 在URL输入：https://api.github.com/users/github
  3. Method选择GET
  4. 点击Send按钮！

你将能够获取GitHub的公开信息。

API响应是什么样的？​

API通常以JSON格式发送数据：

{
  "name": "GitHub",
  "location": "San Francisco",
  "public_repos": 344
}
提示

想知道JSON是什么？ 请查看理解JSON数据格式文档！

实战应用示例​

制作博客​

查看博客文章列表：
GET https://myblog.com/api/posts

创建新文章：
POST https://myblog.com/api/posts

制作购物商城​

查看商品列表：
GET https://myshop.com/api/products

添加到购物车：
POST https://myshop.com/api/cart

主要术语总结​

术语含义例子
请求 (Request)向服务器请求某事"请给我天气信息"
响应 (Response)服务器发送的回复"首尔是晴天"
端点 (Endpoint)API的地址/api/weather
方法 (Method)要执行什么操作GET, POST, PUT, DELETE
JSON数据交换格式{"city": "Seoul"}

常见问题 (FAQ)​

Q1：API是免费的吗？​

A：每个API不同！

  • 免费API：公共数据、GitHub等
  • 部分免费API：每天一定次数内免费（Google Maps等）
  • 付费API：支付系统、高级数据等

Q2：如何创建API？​

A：需要学习后端编程。

  • Node.js + Express
  • Python + Django/Flask
  • Java + Spring 学习这些就可以创建API！

Q3：API Key是什么？​

A：它就像可以使用API的密码。

https://api.example.com/data?key=YOUR_API_KEY_HERE

Q4：出现错误怎么办？​

A：API会用错误代码告诉你：

  • 200：成功！
  • 404：找不到
  • 500：服务器错误

详细信息请查看HTTP状态码指南！

下一步 🚀​

如果你理解了API的基础：

  1. ✅ 理解JSON数据格式 - API交换数据的方式
  2. ✅ API Tester - 直接使用API
  3. ✅ HTTP状态码指南 - 理解API响应代码
  4. ✅ cURL Converter - 将API请求转换为各种格式

总结​

API并不难！可以把它想成程序之间对话的方法。

就像餐厅的服务员，API：

  • 接收我们的请求
  • 传达给服务器
  • 把结果带回来

现在你理解API是什么了吗？🎉